60459690 




CONTRpL DATA 
CORPORATION 



NOS VERSION 2 
REFERENCE SET 



VOLUME 4 



PROGRAM INTERFACE 



CDC® COMPUTER SYSTEMS: 
CYBER 180 
CYBER 170 
CYBER 70 
6000 SERIES 



LIST OF MACROS 



ABORT 


11-1 


APPEND 


5-30 


ASSIGN 


4-9 


ATTACH 


5-36 


BKSP 


3-42 


BKSPRU 


3-43 


CATLIST 


5-21 


CHANGE 


5-38 


CHECKPT 


10-5 


CLOCK 


9-2 


CLOSE 


3-20 


CLOSER 


3-23 


CONTROL 


10-2 


CSET 


11-31 


C STATUS 


6-42 


DATE 


9-2 


DAYFILE 


11-1 


DEFINE 


5-32 


DISTC 


11-29 


EDATE 


9-3 


EFFECT 


11-35 


ENCSF 


4-10 


ENDRUN 


11-5 


EREXIT 


6-5 


ETIME 


9-4 


EVICT 


3-51 


EXCST 


10-5 


FILEB 


2-14 


FILEC 


2-14 


FILINFO 


4-26 


GET 


5-19 


GETACT 


6-25 


GETASL 


6-11 


GETCN 


6-41 


GETEM 


6-11 


GETFLC 


6-19 


GETFNT 


4-18 


GETGLS 


6-23 


GETJA 


6-17 


GETJAL 


6-35 


GETJCI 


6-29 


GETJCR 


6-15 


GETJN 


6-10 


GETJO 


6-17 


GET JOS C 


6-33 


GETJSL 


6-12 


GETLC 


6-2 3 


GETLIDA 


11-5 


GETLOF 


6-28 


GETLVL 


6-40 


GETMC 


11-7 


GETPAGE 


6-39 


GETPFP 


6-27 


GETPR 


6-10 


GETRI 


6-40 


GETSS 


6-21 


GETSSID 


6-32 


GETSSM 


1L-8 



GETTL 


6-12 


RPVBLK 


10-10 


GETUSC 


6-36 


RTIME 


9-6 


HTIME 


9-5 


SAVE 


5-15 


J DATE 


9-5 


SETASL 


6-3 


LABEL 


4-11 


SETFAL 


4-3 


LOADD 


11-24 


SETFET 


2-17 


LOADQ 


11-26 


SETFS 


4-3 


LOCK 


4-4 


SETGLS 


6-24 


MACHID 


6-25 


SETJAL 


6-35 


MEMORY 


11-9 


SETJCI 


6-30 


MESSAGE 


11-10 


SETJCR 


6-16 


MODE 


6-2 


SETJOB 


6-31 


MOVE 


11-12 


SETJSL 


6-4 


NORERUN 


11-20 


SETLC 


6-13 


OFFSW 


6-9 


SETLOF 


6-28 


OLD 


5-42 


SETMFL 


6-27 


ONSW 


6-9 


SETPAGE 


6-39 


OPEN 


3-13 


SETPFAC 


5-43 


OVERLAY 


11-21 


SETPFAL 


5-44 


OVWRITE 


3-40 


SETPR 


6-1 


PACKNAM 


6-20,21 


SETRFL 


6-14 


PDATE 


9-6 


SETSC 


6-38 


PERMIT 


5-27 


SETSLM 


11-32 


POSMF 


3-46 


SETSS 


6-16 


PRIMARY 


4-26 


SETSSM 


6-8 


PROMPT 


11-31 


SETTL 


6-4 


PROTECT 


6-31 


SHELL 


6-33 


PSCSF 


4-10 


SKIPB 


3-53 


PURGE 


5-20 


SKIPEI 


3-53 


READ 


3-25 


SKIPF 


3-52 


RE ADC 


3-58 


SK.IPFB 


3-54 


READCW 


3-27 


SKIPFF 


3-52 


READEI 


3-33 


STATUS 


4-4,5 


READH 


3-59 


STIME 


9-7 


READLS 


3-29 


SUBR 


11-13 


READN 


3-32 


SYSCOM 


1-8 


READNS 


3-31 


SYSTEM 


11-13 


READO 


3-60 


TIME 


9-7 


READS 


3-60 


TSTATUS 


11-33 


READSKP 


3-26 


UNLOAD 


3-44 


READW 


3-61 


UNLOCK 


4-4 


RECALL 


11-12 


USECP1J 


6-18 


RENAME 


4-2 


USERNUM 


6-18 


REPLACE 


5-29 


VERSION 


6-22 


REPRIEVE 


10-15 


WAIT 


11-15 


REQUEST 


4-6,7 


WPHR 


3-34 


RERUN 


11-20 


WRITE 


3-34 


RETURN 


3-45 


WRITSC 


3-59 


REWIND 


3-43 


WRITECW 


3-36 


REWRITE 


3-38 


WRITES 1 


3-35 


REWRITEF 


3-39 


WRITEH 


3-59 


REWRITER 


3-39 


WRIT EN 


3-41 


RFILEB 


2-14 


WRITEO 


3-60 


RFILEC 


2-15 


WRITER 


3-35 


ROLLOUT 


6-7 


WRITES 


3-61 


ROUTE 


7-7 


WRITEW 


3-61 


RPHR 


3-25 






RPHRLS 


3-30 







60459690 D 



< 



60459690 



<S5> 



CONTRPL DATA 
CORPORATION 



NOS VERSION 2 
REFERENCE SET 



VOLUME 4 



PROGRAM INTERFACE 



CDC® COMPUTER SYSTEMS: 
CYBER 180 
CYBER 170 
CYBER 70 
6000 SERIES 



REVISION RECORD 



REVISION 



DESCRIPTION 



(04-26-82) 



B 
(01-27-83) 



(09-30-83) 



(10-12-84) 



Manual released. Manual reflects NOS 2.0 at PSE level 562. This manual documents the following new 
features: QAC Interface; revised DSP parameter block; new format of GETFNT macro; new macros 
GETEOJS, SETJOB, SETFS, GETSSID, and GETJOSC; EJT job status and connection status fields; service 
class types; universal availability of the XJ instruction; binary memory dump request (DMB); new 
parameter for the STATUS macro that returns additional information for tape files; and revised CIO 
interface. 

Manual updated to reflect NOS 2.1 at PSR level 580 and to make miscellaneous technical changes. New 
features include extended DSP parameter block, QAC extended GET request, addition to QAC PEEK reply 
block for remote host files, prefix table for DMB processor, and SHELL and WAIT macros. This 
edition obsoletes all previous editions. 

Manual updated to reflect NOS 2.2 at PSR level 596/587 and to make miscellaneous technical changes. 
New features include common libraries, enhanced system security, service class assignment by users, 
expanded equipment status table, and support for CYBER 170 Model 845. This edition obsoletes all 
previous editions. 

Manual updated to reflect NOS 2.3 at PSR level 617 and to make miscellaneous technical changes. New 
features for this release include alternate CATLIST restriction, default charge restriction, 
enhanced CLASS command, support of the 834 Disk Subsystems, support of the 639 Magnetic Tape Units, 
and support of the CYBER 180 Computer Systems. This edition obsoletes all previous editions. 



Publication No. 
60459690 



REVISION LETTERS I, O, Q. S, X AND Z ARE NOT USED. 



Address comments concerning this 
manual to: 



© 1982, 1983, 1984 

by Control Data Corporation 

All rights reserved 

Printed in the United States of America 



Control Data Corporation 
Publications and Graphics Division 
4201 North Lexington Avenue 

St. Paul, Minnesota 55112 

or use Comment Sheet in the back of 
this manual. 



LIST OF EFFECTIVE PAGES 



New features, as well as changes, deletions, and additions to information in this manual, are indicated by bars in the margins or by a dot 
near the page number if the entire page is affected. A bar by the page number indicates pagination rather than content has changed. 



DlftC 
rnwi- 


REV 


Front Cover 


- 


Inside Front 




Cover 


D 


Title Page 


- 


2 


D 


3 


D 


4 


D 


5 


D 


6 


D 


7 


C 


8 


D 


9 


D 


10 


D 


11 


D 


12 


D 


13 


D 


1-1 


C 


1-2 


D 


1-3 


A 


1-4 


B 


1-5 


A 


1-6 


C 


1-7 


A 


1-8 


B 


1-9 


B 


1-10 


B 


1-11 


A 


1-12 


B 


1-13 


B 


1-14 


B 


1-15 


A 


1-16 


A 


1-17 


D 


1-18 


D 


1-iy 


C 


1-20 


D 


1-21 


D 


2-1 


B 


2-2 


B 


2-3 


B 


2-4 


C 


2-5 


c 


2-6 


c 


2-7 


A 


2-8 


c 


2-9 


A 


2-10 


c 


2-11 


B 


2-12 


C 


2-13 


B 


2-14 


A 


2-15 


A 


2-16 


A 


2-17 


A 


2-18 


B 


2-19 


A 


2-20 


B 


3-1 


C 


3-2 


D 



PAGE 


REV 


3-3 


A 


3-4 


B 


3-5 


A 


3-6 


C 


3-7 


A 


3-8 


B 


3-9 


A 


3-10 


B 


3-11 


B 


3-12 


C 


3-13 


C 


3-14 


C 


3-15 


A 


3-16 


D 


3-17 


D 


3-18 


A 


3-19 


A 


3-20 


C 


3-21 


A 


3-22 


A 


3-23 


C 


3-24 


C 


3-25 


C 


3-26 


C 


3-27 


C 


3-28 


A 


3-29 


C 


3-30 


C 


3-31 


c 


3-32 


c 


3-33 


c 


3-34 


c 


3-35 


c 


3-36 


B 


3-37 


D 


3-38 


c 


3-39 


c 


3-40 


c 


3-41 


c 


3-42 


c 


3-43 


c 


3-44 


c 


3-45 


c 


3-46 


c 


3-47 


A 


3-48 


A 


3-49 


A 


3-50 


A 


3-51 


c 


3-52 


C 


3-53 


C 


3-54 


C 


3-55 


A 


3-56 


A 


3-57 


B 


3-58 


A 


3-59 


A 


3-60 


B 


3-61 


B 



PAGE 


REV 


3-62 


A 


4-1 


B 


L--> 





4-3 


c 


4-4 


B 


4-5 


c 


4-6 


c 


4-7 


c 


4-8 


D 


4-9 


A 


4-10 


A 


4-11 


A 


4-12 


A 


4-13 


A 


4-14 


A 


4-15 


D 


4-16 


D 


4-17 


A 


4-18 


B 


4-19 


D 


4-20 


D 


4-21 


c 


4-22 




4-23 


D 


4-24 


c 


4-25 


A 


4-26 


D 


4-27 


C 


4-28 


B 


4-29 


D 


4-30 


D 


5-1 


D 


5-2 


D 


5-3 


c 


5-4 


C 


5-5 


B 


5-6 


C 


5-7 


A 


5-8 


B 


5-9 


C 


5-10 


D 


5-11 


B 


5-12 


B 


5-13 


D 


5-14 


D 


5-15 


D 


5-16 


D 


5-17 


D 


5-18 


B 


5-19 


C 


5-20 


B 


5-21 


D 


5-22 


D 


5-23 


D 


5-24 


D 


5-25 


c 


5-26 


D 


5-27 


D 


5-28 


C 



5-29 

5-30 

5-31 

5-32 

5-33 

5-34 

5-35 

5-36 

5-37 

5-38 

5-39 

5-40 

5-41 

5-42 

5-43 

5-44 

5-45 

6-1 

6-2 

6-3 

6-4 

6-5 

6-6 

6-7 

6-8 

6-9 

6-10 



6-11 


D 


6-12 


A 


6-13 


C 


6-14 


B 


6-15 


A 


6-16 


C 


6-17 


D 


6-18 


o 


6-19 


A 


6-20 


c 


6-21 


C 


6-22 


B 


6-23 


B 


6-24 


B 


6-25 


A 


6-26 


c 


6-27 


B 


6-28 


B 


6-29 


A 


6-30 


A 


6-31 


B 


6-32 


D 


6-33 


C 


6-34 


D 


6-35 


C 


6-36 


D 


6-37 


D 


6-38 


D 


6-39 


c 


6-40 


D 


6-41 


D 


6-42 


D 



c 

B 
C 
D 
D 
D 
B 
D 
B 
D 
D 
D 
D 
C 
C 
C 
C 
D 
D 
D 
A 
A 
D 
C 
A 
B 
B 



PAGE 


REV 


7-1 


D 


7-2 


D 


7-1 


B 


7-4 


B 


7-5 


D 


7-6 


D 


7-7 


c 


7-8 


A 


7-9 


D 


8-1 


D 


8-2 


D 


8-3 


D 


8-4 


D 


8-5 


A 


8-6 


c 


8-7 


D 


8-8 


B 


8-9 


C 


8-10 


D 


8-11 


D 


8-12 


D 


8-13 


D 


8-14 


D 


8-15 


D 


8-16 


C 


8-17 


D 


8-18 


C 


8-19 


C 


8-20 


A 


8-21 


C 


8-22 


B 


8-23 


D 


9-1 


A 


9-2 


B 


y-j 


i) 


9-4 


B 


9-5 


B 


9-6 


A 


9-7 


D 


10-1 


B 


10-2 


A 


10-3 


A 


10-4 


B 


10-5 


A 


10-6 


A 


10-7 


C 


10-8 


C 


10-9 


D 


10-10 


B 


10-11 


A 


10-12 


D 


10-13 


B 


10-14 


D 


10-15 


D 


11-1 


D 


11-2 


D 


11-3 


C 


11-4 


C 


11-5 


D 



60459690 D 



PAGE 


REV 


PAGE 


REV 


PAGE 


REV 


11-6 


D 


B-9 


D 


H-7 


A 


11-7 


B 


B-10 


D 


H-8 


A 


11-8 


D 


B-ll 


D 


H-9 


A 


11-9 


C 


B-12 


D 


1-1 


A 


11-10 


A 


B-13 


D 


1-2 


A 


11-11 


D 


B-14 


D 


1-3 


A 


11-12 


C 


B-15 


D 


1-4 


D 


11-13 


c 


B-16 


D 


1-5 


A 


11-14 


D 


B-l 7 


D 


1-6 


C 


11-15 


B 


B-l 8 


D 


1-7 


A 


11-16 


C 


B-19 


D 


1-8 


C 


11-17 


C 


B-20 


D 


J-l 


D 


11-18 


C 


B-21 


D 


J-2 


A 


11-19 


D 


B-22 


D 


J-3 


A 


11-20 


D 


B-23 


D 


J -4 


A 


11-21 


C 


B-24 


D 


J-5 


A 


11-22 


C 


B-25 


D 


J-6 


C 


11-23 


B 


C-l 


C 


J-7 


A 


11-24 


A 


C-2 


B 


J-8 


A 


11-25 


A 


C-3 


A 


K-l 


D 


11-26 


C 


C-4 


D 


K-2 


D 


11-27 


B 


C-5 


D 


K-3 


D 


11-28 


A 


C-6 


C 


K-4 


C 


11-29 


D 


C-7 


D 


L-l 


D 


11-30 


D 


C-8 


B 


L-2 


D 


11-31 


B 


C-9 


B 


L-3 


D 


11-32 


D 


C-10 


A 


L-4 


D 


11-33 


C 


C-ll 


A 


L-5 


D 


11-34 


D 


C-12 


C 


M-l 


D 


11-35 


D 


C-13 


D 


M-2 


D 


12-1 


A 


C-l 4 


D 


M-3 


D 


12-2 


C 


D-l 


D 


Index-1 


D 


12-3 


A 


E-l 


C 


Index-2 


D 


i^*-H- 


B 


E— 2 


C 


Index-3 


D 


12-5 


B 


E-3 


B 


Index-4 


D 


12-6 


D 


E-4 


D 


Index-5 


D 


12-7 


D 


E-5 


D 


Index-6 


D 


12-8 


D 


E-6 


C 


Index-7 


D 


12-9 


D 


E-7 


C 


Index-8 


D 


12-10 


D 


E-8 


C 


Index-9 


D 


12-11 


A 


E-9 


C 


Index- 10 


D 


12-12 


D 


E-10 


D 


Index- 11 


D 


12-13 


D 


E-ll 


D 


Index- 12 


D 


12-14 


D 


E-12 


C 


Index-13 


D 


12-15 


D 


F-l 


B . 


Comment Sheet 


D 


12-16 


B 


F-2 


C 


Back Cover 


- 


12-17 


D 


F-3 


c 






12-18 


D 


F-4 


c 






A-l 


A 


F-5 


D 






A-2 


C 


F-6 


D 






A-3 


C 


F-7 


D 






A-4 


C 


F-8 


D 






A-5 


C 


F-9 


C 






A-6 


C 


F-10 


C 






A-7 


C 


F-ll 


A 






A-8 


C 


G-l 


D 






A-9 


C 


G-2 


A 






A- 10 


C 


G-3 


A 






A-ll 


C 


G-4 


A 






A- 12 


D 


G-5 


A 






A-13 


C 


G-6 


A 






A- 14 


C 


G-7 


A 






A-15 


C 


G-8 


A 






B-l 


A 


G-9 


D 






B-2 


D 


G-10 


A 






B-3 


D 


H-l 


A 






B-4 


D 


H-2 


A 






B-5 


D 


H-3 


A 






B-6 


D 


H-4 


B 






B-7 


D 


H-5 


B 






B-8 


D 


H-6 


A 







PAGE 



REV 



PAGE 



REV 



60459690 D 



PREFACE 
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of CDC® CYBER 180 Computer Systems", Models 810, 830, 835, 845, and 855; CDC CYBER 170 
Computer Systems, Models 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 760, 815, 825, 
835, 845, 855, 865, and 875; CDC CYBER 70 Computer Systems, Models 71, 72, 73, and 74; and 
CDC 6000 Computer Systems. 

The N0S Reference Set, composed of four separate volumes, describes the external features of 
NOS 2. 



AUDIENCE 

Volume 1, Introduction to Interactive Osage, is written for the novice. 

Volume 2, Guide to System Usage, is written for the applications or systems programmer who 
is unfamiliar with NOS. 

Volume 3, System Commands, is written for all NOS users. 

Volume 4, Program Interface, is written for the experienced COMPASS applications programmer 
or systems programmer. 

The reader of each volume should have a knowledge of the material contained in the previous 
volumes. 



ORGANIZATION 

Volume 1, Introduction to Interactive Usage (60459660), shows a user at an interactive 
terminal how to enter, run, and correct programs, and how to create, retrieve, and maintain 
permanent files. Other topics covered include physical terminal connection and login/logout 
procedures . 

Volume 2, Guide to System Usage (60459670), describes the general concepts of NOS and some 
of the utilities used with NOS. Topics included are job processing, file concepts, 
procedures, magnetic tape processing, Modify, and loading files. This volume is to be used 
as a learning tool and does not contain comprehensive descriptions of all NOS commands. 

Volume 3, System Commands (60459680), describes the system commands that form the user 
interface to NOS. 

Volume 4, Program Interface (60459690), describes the COMPASS program interface to NOS. 
Detailed descriptions of function processors and macros available to COMPASS user programs 
are included. 
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CONVENTIONS 

The following notational conventions are used throughout this manual . 

SYSTEM REQUEST AND MACRO FORMATS 

The system request and macro formats in this manual are presented using both uppercase and 
lowercase characters. Uppercase characters must be entered exactly as shown; lowercase 
characters are to be replaced with the appropriate characters as described in the text. 

The auto recall parameter is a special case. This parameter is shown in uppercase for all 
requests except CIO requests. However, the system processes all non-CIO requests made by 
user programs with auto recall, regardless of whether or not the auto recall parameter is 
specified in the request. The system processes CIO requests with auto recall only if the 
auto recall parameter is specified in the request. 



NUMBER BASE NOTATION 

Decimal base is used throughout this manual except where otherwise noted. Octal integers 

grgafflr f-han 7 r\r 1_t_c *->!£« —1 a^a t-t-s-J *-*-^t-. t.t-?*-V* « at-M^n** «*■ Q ~ -_ j-*-*^ ,*-«„ „.___■! r-._j._-! i 

&- 1 ^- ----- — ~_ -__._• w wn«i»» . _,_ _• *__.___._» HXk.ii t* au_K)_l.4.f b V _■ _ _Ll_. V%\JJ. U UtL-J.( U_UCLX _><__ 

is used in the following contexts: 

• Address indices for memory tables and parameter blocks . 

• Display code values. 

• Function codes of macros . 

• Numbers of words in memory. 

• Numerical fields in memory. 

Decimal base is used in all program examples except where the BASE OCTAL pseudoinstruction 
or the postradix B is used. 



EXTENDED MEMORY 

Extended memory for model 176 is large central memory extended (LCME). Extended memory for 
CYBER 180-class models and models 865 and 875 is unified extended memory (UEM) . Extended 
memory for models 865 and 875 may also include either extended core storage (ECS) or 
extended semiconductor memory (ESM) . Extended memory for all other NOS computer systems is 
either ECS or ESM. ECS and ESM are the only forms of extended memory that can be shared in 
an ECS multimainframe complex and can be accessed by a distributive data path (DDP). 

In this manual, ECS refers to both ECS and ESM, and extended memory refers to all forms of 
extended memory lihiess otherwise noted. 

Programming information for the various forms of extended memory can be found in the COMPASS 
Version 3 Reference Manual and in the appropriate computer system hardware reference 
manual . 
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MEMORY WORD FORMATS 

The following notations are used in memory word formats: 

• Bits of memory words are numbered in decreasing order from left to right, starting 
with 59 on the left and ending with on the right. 

• Bytes (12-bit portions) of memory words are numbered in increasing order from left 
to right, starting with (byte consists of bits 59 through 48, byte 1 consists of 
bits 47 through 36, byte 2 consists of bits 35 through 24, byte 3 consists of bits 
23 through 12, and byte 4 consists of bits 11 through 0). 

• Fields that contain only capital letters indicate portions of memory that contain 
the display code values for those letters. 

• Diagonal lines ( Y/ZX ') indicate a portion of memory that is not used by the system 
and may contain any value. These portions may, however, be used by future versions 
of NOS. 

• The word 'reserved' or the phrase 'reserved for Control Data' indicates a portion of 
memory that is either used internally by the system or is reserved for future use. 
The phrase 'reserved for installations' indicates a portion of memory that each 
installation may use in whatever manner it chooses. 

• A zero indicates a portion of memory that contains all binary zeros. 



CHARACTER SETS 

The ASCII character set is used in the examples in this manual. Other NOS-compatible 
character sets are described in appendix A. 



RELATED PUBLICATIONS 

The following manuals contain information directly related to the material presented in this 
volume. 

The NOS Manual Abstracts is a pocket-sized manual containing brief descriptions of the 
contents of all NOS and NOS product manuals. The abstracts can be useful in determining 
which manuals are of greatest interest to you. 

Control Data also publishes a Software Publications Release History of all software manuals 
and revision packets it has issued. This history lists the revision level of a particular 
manual that corresponds to each released level of software. 

These manuals are available through Control Data sales offices or Control Data Literature 
Distribution Services, 308 North Dale Street, St. Paul, MN 55103. 
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DISCLAIMER 
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PROGRAM/SYSTEM COMMUNICATION 



The Network Operating system (NOS) allows communication between a CPU program and ^redeiineu 
system routines and functions as follows: 

• RA+1 system requests to function processors. 

• NOS systems texts. 

• Macros.* 

• Common decks JT 

These routines enable you to perform complex operations with a minimum of coding. They have 
been thoroughly tested and optimized, and are designed to meet system interface requirements. 



FUNCTION PROCESSORS 

Several NOS system routines process user requests. Sections 3 through 11 contain 
descriptions of each function processor, including: 

• Identification of the requests (function numbers). 

• Systems texts containing macros and symbol definitions needed to issue the requests. 

• System macros (or common decks containing macros) available to issue the requests. 

• Common decks containing efficient code and macros to issue the requests. 

• Information returned from the processor after the requests. 

Following is a list of the NOS function processors whose system request formats are 
described in this manual. 

Processor Description Section 

ABT Exit processing request H 

CIO Combined input/output 3 

CKP Checkpoint processor 10 

CPM Control point manager 6 



tRefer to the COMPASS Version 3 Reference Manual for a complete description of how macros 

are defined and used. 
ftRefer to the Modify Version 1 Reference Manual for a complete description of how common 
decks are defined and used. 
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Processor 

CVL 

DED, DEP 

DMB 

DMD, DMP 

DSP 

END 

LDD, LDQ 

LDR, LDV 

LFM 

MEM 

MSG 

PFM 

QAC 

QFM 

RCL 

RFL 

RPV 

SFM 

TCS 

TIM 

TLX 

WCL 



Descript ion 
Common validation interface processor 
Extended memory dump 

Binary dump of central memory and extended memory 
Central memory dump 
File routing 

Program termination request 
Fast dynamic loading 
Overlay request 
Local file manager 
Memory requests 
System message processor 
Permanent file manager 
Queue access interface 
Queue file manager 
Recall CPU 
Memory requests 
Reprieve processing 
System file manager 
Command translator 
Time and date functions 
Interactive terminal requests 
Recall CPU for a specified time 



Section 

11 

11 

11 

11 
7 

11 

11 
11 

4 
11 
11 

5 

8 
11 
11 
11 
10 
11 
10 

9 
11 
11 



SYSTEM REQUESTS 

^LnTr^r^r,! 1 ^ th t Sy f em iS P erformed b ? "tering a system request in location 1 
£_?t ?C S and executln & an exchange jump (XJ) instruction (refer to figure 

11). The system then initiates execution of that portion of the system required to satisfy 
the request. There are two types of system requests. 

• Those that contain all information necessary in RA+1 (for example, RCL). 

• Those that require additional areas for parameters or results from the system; for 
example, CIO requires the specification of a file environment table (FET). 
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The format of the 60-bit request is one of the following (depending on whether two or three 
parameters are to be passed). 



RQ 




40 


35 


23 




•1 





fff g R 


% 


P 3 


fz 


P1 


59 




40 35 17 







fff ^R 


% 


P 2 


Pi 



fff 

R 
Pl»P2»P3 



System request name. 

Auto recall bit. 

Parameters passed to the portion of the system that processes fff. 



SYSTEM REQUEST PROCESSING 

Whether a system request communicates with a FET or another parameter block, the first word 
of this area is usually the status word. Both the system and the user program use the lower 
portion of this word to communicate the status of the request. When bit is cleared 
(equals 0), the system is in control of the request; when it is set (equals 1), the user 
program is in control of the request . 

For example, to write on file ABC, the user program must perform the following steps (if you 
use the macro interface described in section 3, the common decks COMCCIO and COMCSYS perform 
these steps for you). 

1. Check the status (bit of the first word of the FET, address 2000 in the example) 
of ABC. 

2. If ABC is busy (bit cleared), the user program must wait until bit is set. This 
is done by issuing a system request to recall (RCLP), or by issuing a RECALL macro 
on the FET. 

3. When ABC is idle (bit set), the user program must clear bit and place the 
request in RA+1. 

4. If other processing can be performed, the user program proceeds. 

5. If further processing depends upon ABC being completed, the user program must check 
the status word for completion (bit set by the system). 
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To perform this write operation on file ABC, the user program issues a system request to 
CIO. The following diagram illustrates the program/system control when performing this 
operation. 



User Program Control of ABC 



System Control of ABC 



RA+1 



CIO 



2000 



2000 



3 



RA+1 



User Program Control of ABC 



RA+1 



ABC 



16 



2000 




2000 



ABC 



17 



The user program requests the system 
to take control of ABC by clear- 
ing bit of the first word of the 
FET (address 2000) and entering 
CIO 2000 in RA+1. 



The system clears 
RA+1 upon begin- 
ning processing of 
the request. 



The system sets bit of 
the first word of the 
FET upon completing the 
request. 



In many situations, the program cannot proceed until the system request Is complete (as in 
steps 2 and 5 when ABC is busy). The user program can prevent further execution until the 
request is complete (bit of the first word of the FET set) by issuing a recall (RCLP) 
request or a RECALL macro on the FET after the CIO request or by specifying the auto recall 
bit on the original CIO request. This reduces the amount of CPD time used by the job. 



If the request In the previous example were Issued with auto recall specified, 



RA+1 


CI OP 2000 


— 




















L> 






2000 


ABC 16 











P is the display code representation of the 
auto recall bit (20 8 ); that is, bit 40 of 
RA+1 is set. 



the system would not allow the job to continue execution until bit of word 2000 is set. 
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The program must perform the following steps to process the request with auto recall (if you 
use the macro interface described in section 3, the common decks COMCCIO and COMCSYS perform 
these steps for you) . 

1. Check the status of ABC (bit of word 2000, which is the first word of the FET). 

2. If ABC is busy, wait until bit is set and return to step 1. This can be done by 
xS3Uj.uu an RkijF request or a rdLi..rt I J 7. macro on word 2000* 

3. Clear bit of word 2000 and place the CIOP request in EA+1. 

Processing can proceed with the assurance that the previous operation on ABC is completed 
(bit of word 2000 does not have to be checked) . 

You should be aware that many system requests require that the auto recall bit be set. This 
is noted in the description of the requests where applicable. 



ISSUING RA+1 REQUESTS 

When a system request is placed in RA+1, the user program should issue an exchange jump 
instruction (XJ) to ensure immediate processing of the request. 

When the system detects a request in RA+1 that can be processed, RA+1 is cleared and 
processing begins. 

The following example illustrates the steps involved in processing a system request. 

1. The user program issues a CIO request on the FET address, without the auto recall 
bit set.tto RA+1. 

2. The user program issues an XJ instruction. 

3. The system immediately accepts the CIO request. The user program begins to execute 
again only after the system has started processing the request. 

4. At the point where the user program requires that the CIO request be completed 
before further instructions are executed, the program issues an RCLP request on the 
FET address. This prevents the user program from continuing until the CIO request 
is completed. 

The user program places the system request in RA+1 and executes an XJ instruction. The CPU 
is exchanged to the system program CPUMTR from the user program. The system acts upon the 
request immediately. 

If you use the macros described in this manual, the common deck COMCSYS places the function 
request in RA+1 and issues the XJ instruction for you. 



tlf the CIO request in this example were made with the auto recall bit set, step 4 would 
not be necessary because the user program would not resume execution until the CIO request 
completes . 
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NOS SYSTEMS TEXTS 

The following systems texts are available to you. 

• SYSTEXT. 

• PPTEXT. 

• NOSTEXT. 

• PSSTEXT. 

• ECSTEXT. 

Although other systems texts exist, the macros described in this manual are supported only 
in the systems texts just listed. 

SYSTEXT contains system communication macros that are used by the CPU COMPASS programmer. 
PPTEXT contains symbol definitions used by all system PP routines for intercommunication and 
contains the micro NOSVER as defined in the system OPL common deck COMSVER. NOSTEXT 
contains all system communication macros, micros, and symbol definitions that are found in 
SYSTEXT and PPTEXT. 



NOTE 



In order to use symbol definitions contained 
in a systems text, you must include the COM- 
PASS pseudoinstruction SST in your program. 

PSSTEXT contains macros that are defined on system OPL common decks COMCMAC and COMCCMD, and 
the micro NOSVER defined on system OPL common deck COMSVER (refer to Common Deck Usage in 
this section and to appendix F). 

ECSTEXT contains operation definitions that are defined on common deck COMCECM. These 
definitions provide instructions for interpretive mode reading and writing of extended 
memory (refer to appendix D) . 

By selecting the correct systems text (for the applications COMPASS programmer, this is 
usually SYSTEXT and/or PSSTEXT), you can reduce the amount of system resources needed for 
assemblies. 

To obtain listings of the systems texts, enter one or more of the following commands after 
accessing the system OPL.t 

MOD IFY,Q,CL,CS=0,Z./*ED IT, SYSTEXT 

MOD IFY , Q , CL , CS=0 , Z . /*EDIT , PPTEXT 

MODIFY ,Q , CL, CS=0 , Z. /*EDIT , NOSTEXT 

MOD IFY, Q,CL,Z./*EDIT, ECSTEXT 



tYour site must control access to the system OPL as required by the site's licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the 
system OPL. These examples (and all following examples) assume that you have the system 
OPL available with a local file name of OPL. 
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To obtain a listing of PSSTEXT, enter the following commands after accessing the system OPL. 
MODIFY, Z./*EDIT, PSSTEXT 
COMPASS, I, LO=X. 



MACRO USAGE 

Macros are available for issuing most requests to the function processors. If macros are 
not available, you can define your own using the MACRO pseudoinstruction (refer to the 
COMPASS Version 3 Reference Manual). 

A macro is a predefined sequence of COMPASS statements that can be used in a program. You 
can use predefined macros by specifying the location of the macro definitions to COMPASS 
with the S or G parameter. For example: 

COMPASS, I, B, S=XYZTEXT. 

This call causes all macro definitions in XYZTEXT to be available for assembly of the 
program. If no S parameter is specified, COMPASS uses the system default system text 
SYSTEXT. The macros described in this manual, unless otherwise noted, are defined in 
SYSTEXT and NOSTEXT. 

Some macros are defined in common decks. To assemble programs containing these macros, the 
common deck must be called into the text of the program (refer to Common Deck Usage in this 
section). If a macro is defined in common deck COMCMAC or COMCCMD, you have the option of 
specifying the alternate systems text PSSTEXT. For example: 

COMPASS , I , B , S , S=PSSTEXT . 

This makes available all macro definitions in PSSTEXT (that is, those defined in common 
decks COMCMAC and COMCCMD) as well as all macros in SYSTEXT for the assembly of the program. 

In addition to the macros available in SYSTEXT, an integer divide operation definition is 
provided for your convenience. Its format is as follows: 

IXi Xj/Xk 

The operation divides Xj by Xk and places the result in Xi. The contents of registers Xj, 
Xk, and B7 are destroyed. 

When a macro parameter refers to an address, the parameter may generally be a register name, 
a relocatable address, an external symbol, or an absolute address. You should consult the 
expansions of the system macros to determine whether registers can be used with a given 
macro and, if so, the optimum use of registers. You are responsible for ensuring that a 
register used as a parameter contains only the parameter (for example, if an 18-bit address 
is specified by an X register, you must in some cases ensure that the upper 42 bits of the 
register are zero). 
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Most NOS system macros and common decks preserve the contents of the following registers. 
AO, XO, A5, and X5 

Also, upon exit, the contents of registers Bl and X2 are as follows: 
Bl 1 

X2 FET address (refer to section 2) , if a macro specifies the FET address as a parameter 

2S\E in C ^ubt! S ^ th6Se rUleSJ ^ 8h ° Uld refer t0 d — ntation of a macro or common 

The contents of the Bl register are assumed to be 1 upon entry only if the SYSPOM m „.,., 
is called or the Bl-1 COMPASS pseudoinstruction is defined! ° 

SYSCOM 

The SYSCOM macro performs the following functions. 

• Optionally defines the Bl-1 COMPASS pseudoinstruction. 

• Defines system communication symbols. 

oLur^Vtt™ rogra^' " Sh ° Uld ^ ^^ bef0 " -~»" bl - ■«"«*■ or common decks 
Macro format: 

Location Operation Variable 



SYSCOM Bl 



Bl 



If present, COMPASS pseudoinstruction Bl=l is defined. 



Many system common decks called from macros assume the contents of the Bl register to be 
'1,° A e l C °T n d ?^ S 3SSUme B1 is equal t0 1 onl y if the macr ° SYSCOM Bl or 
Som call ^"f T" ° n B1=1 " defined ' " the B1 P ara ^ter is not included in the 
SYSCOM call or if there is no SYSCOM call, these common decks then generate additional code 

rl.T l^T 1 t0 U " SYSC ° M B1 ° r the B1=1 P^udoinstruction if used, it is" youl 
responsibility to set the Bl register equal to 1. This should be done as the fLst 
instruction executed in the program. 

col!n^ 1 ^ Cati0 \°f S J S °f (Wlth ° r With ° Ut s P eclf ™ BD also makes available the system 
communication symbols (refer to figure E-l). These are: s»ys>tem 

Symbol Value n i *. ■ 

_j_ viiue Description 

RA.MTR i ., , r _ . , , 

A Address of RA+1. 

ARGR 2 ij. , , _, 

*■ Address of the first argument. 

SPPR 27a - -, 

8 Special program parameter area (locations 

2/8 through 47s). 
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Symbol 



Value 



Description 



PGNR 
ACTR 
CMUR, RA.CMU 



64 8 
64 8 
65 8 



Program name (bits 59 through 18). 
Argument count (bits 17 through 0). 
Compare/move unit (CMU) available flag 



LWPR 



65 8 



FWPR 

JOPR 

XJPR, RA.CEJ 

CSMR 

LDRR 
CCDR 
LINP 



66 8 

66 8 
66 8 

67 8 

67 8 
70 8 
60 10 



LWA+1 of the assigned program space (bits 
17 through 0). If Common Memory Manager 
is loaded in your job's field length, bits 
17 through contain the complement of the 
LWA+1 of the assigned program space (refer 
to the Common Memory Manager Reference 
Manual ) . 

FWA of the assigned program space (bits 17 
through 0). 

Job origin type (bits 35 through 24). 

Central exchange available (bit 59). This 
bit is always set. 

System character set mode flag (bit 59); 
set if 64-character set mode. 

LDR completion (bit 29). 

Command image (eight locations). 

Lines per page; used to format output. 



COMMON DECK USAGE 

A system common deck is a COMPASS subroutine or group of macro or symbol definitions that 
have been tested, optimized, and placed on a program library from which you can access them. 

All of the common, decks supplied with the system are available to any user who has access to 
the system OPL.t The OPL is a collection of records of text that can be accessed randomly 
by the Modify utility program. Refer to MODIFY command in section 13 of Volume 3, System 
Commands, or to the Modify Version 1 Reference Manual. Normally, the system OPL is available 
as a direct access permanent file and you must issue an ATTACH command before Modify runs. 

Several classes of system common decks exist; however, you need only be concerned with the 
CPU common decks. Documentation of the common decks provided with the system OPL can be 
obtained with the following commands after the system OPL is accessed. 

MODIFY, Z./*EDIT,CALLCPU 
DOCMENT. 

To obtain a complete listing of the routines, enter the following command. 

MODIFY ,Q , CL , CS=NOSTEXT , Z . /*EDIT , CALLCPU 



tYour site must control access to the system OPL as required by the site's licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the 
system OPL. 
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Appendix F contains a list of the CPU common decks of general interest and describes their 
functions. 

CPU common deck names have the following format. 

COMCxxx 

COM Indicates a common deck. 

C Specifies CPU common deck. 

xxx Entry point name (sometimes defined inside the routine as xxx=). 

The typical COMPASS programmer who is writing relocatable programs is generally unaware of 
the common deck interface, and needs only be concerned if a common deck of unique nature 
(for example, the common deck that converts display code to binary representations) is 
required, or if the specified common deck is not on the system library (SYSLIB). Refer to 
appendix F for a list of common decks available in relocatable form on SYSLIB. 

Two common decks (COMCMAC and COMCCMD) are also available on systems text PSSTEXT. You have 
the option of either calling these decks from the system OPL or specifying the alternate 
systems text PSSTEXT as described under Macro Usage, earlier in this section. 

Most system macros require that the coinmo" deck related to a function processor be available 
in the program; however, you do not need to specifically call them when assembling 
relocatable programs, since all macros specify entries to common decks as external symbols. 
When the relocatable subroutines are loaded, the routines required at execution time (such 
as LFM= and CIO= ) are loaded from SYSLIB. 

For example, a subroutine uses the following macro. 



READ ABC,R 

This macro requires routines CIO= and SYS= ; however, the READ macro generates: 

RJ =XCIO= 
and CIO= generates: 

RJ =XSYS= 

Since these are flagged as external references (=X), the loader satisfies them from SYSLIB 
if they are not locally satisfied. 

If a program is not relocatable or if the desired common deck is not on SYSLIB, then a 
system common deck must be accessed from the system OPL. 
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To use a common deck, either insert the Modify directive *CALL in the text of your program, 
use the COMPASS pseudoinstruction XTEXT, or, for a relocatable program, reference the entry 
point as an external so that it is loaded and linked from SYSLIB. 



NOTE 



When using a common deck, you should be 
aware both of the entry and exit conditions 
for the common deck and of which registers 
that deck uses. These are contained in the 
documentation within each common deck. 



The following example illustrates the procedure for using the *CALL directive. 



J0B1. 

USER,USERNAM,PASSWRD. 

CHARGE,*. 

COPYBR,INPUT,XFILE. 

ATTACH,OPL/UN=LIBRARY. 

RFL,45000. 

MODIFY,Q,CL. 

LGO. 

-EOR- 

PROG 



THE 

OUTPUT 

START 



I DENT 

ABS 

ENTRY 



PR0G,TME 



START 



COPY PROGRAM TO XFILE 
ATTACH OPL 

CALL MODIFY PROGRAM 

LOAD AND EXECUTE COMPASS BINARY 

DECK NAME TO BE EDITED 

BODY OF ABSOLUTE COMPASS PROGRAM 
THAT OUTPUTS THE CURRENT TIME 



SYSCOM B1 



ORG 

CON 

FILEC 

SB1 

CLOCK 

SA5 

BX6 



11QB 



OBUF,101 

1 

TME 

TME 

X5 



*CALL 

*CALL 

*CALL 

OBUF 

-EOR- 
* REWIND 
•CREATE 
*EDIT PROG 
-EOI- 



WRITEO OUTPUT 
WRITER OUTPUT 
ENDRUN 
COMCCIO 
COMCWTO 
COMCSYS 
BSS 101B 

END 

XFILE 
XFILE 



B 



CLOCK MACRO REQUIRES 
COMMON DECK COMCSYS 

WRITEO MACRO REQUIRES COMMON 
DECK COMCWTO, WRITER REQUIRES 
COMCCIO, ENDRUN REQUIRES COMCSYS 

MODIFY DIRECTIVES TO INSERT 
SPECIFIED COMMON DECKS 



MODIFY INPUT DIRECTIVES- 
REPOSITION XFILE TO BOI 
CREATE PROGRAM LIBRARY 

MODIFY DECK PROG 
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After the system OPL is attached, the Modify utility edits the COMPASS deck by inserting the 
common decks in place of the respective *CALL statements. The Q parameter on the MODIFY 
command causes Modify to call COMPASS to assemble the resultant COMPASS program. The CL 
parameter specifies COMPASS list output. The COMPASS listing from this program does not 
contain a listing of the called common decks, since these common decks contain the CTEXT 
pseudoinstruction. Instead, the following is provided. 



OBUF 



ENDRUN 

CTEXT 

CTEXT 

CTEXT 

BSS 

END 



COMCCIO - I/O FUNCTION PROCESSOR. 
COMCWTO - WRITE ONE WORD. 
COMtSYS - PROCESS SYSTEM REQUEST. 
101B 



To have the specified common decks listed in the program, you must use the COMPASS LIST 
pseudoinstruction in the program, or use list options in the COMPASS command. 

The net effect of the *CALL statement is that the text for the specified common deck is 
inserted at that position in the program text. In the previous example, the assembler would 
receive the following text. 



COMCC 10 



CIO= 



WRITER OUTPUT 
ENDRUN 



PS 



EQ 



COMCWTO 



WTO= 



COMCSYS 



SYS= PS 



ENTRY/EXIT 



CIO= RETURN 



PS 



RJ =XCIO= 



ENTRY/EXIT 



ENTRY/EXIT 



END 
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The procedure for using the COMPASS pseudoinstruction XTEXT to obtain common decks is 
detailed in the following example. 



J0B2. 

USER,USERNAM, PASSWRD. 

CHARGE,*. 

COMPASS. 

LGO. 

-EOR- 





IDENT 


PROG, THE 




ABS 






ENTRY 


START 




SYSCOM 


B1 




0R6 


110B 


TME 


CON 





OUTPUT 


FILEC 


OBUF, 101 B 


START 


SB1 


1 




CLOCK 


THE 




SA5 


TME 




BX6 


X5 




WRITEO 


OUTPUT 




WRITER 


OUTPUT 




ENDRUN 




OPL 


XTEXT 


COMCSYS 


OPL 


XTEXT 


COMCWTO 


OPL 


XTEXT 


COMCCIO 


OBUF 


BSS 
END 


101B 



-EOI- 



After attaching the system OPL, a call is made to the COMPASS assembler. The XTEXT 
pseudo instruction provides a means of obtaining source statements from a file other than 
that being used for input. COMPASS transfers the text from the external source and 
assembles it before taking the next statement from the program. 

A COMPASS listing from a program using the XTEXT pseudoinstruction also does not list the 
inserted common decks. These can be obtained with the COMPASS LIST pseudoinstruction or by 
using list options on the COMPASS command. 

A conflict of tags is one problem that may arise when using common decks. Since all tags 
and routine names within common decks conform to the NOS programming specifications (refer 
to appendix I), each routine name relates to its particular function. Normally, all system 
common decks are automatically qualified by the common deck name (refer to the description 
of the QUAL pseudoinstruction in the COMPASS Version 3 Reference Manual) , so that no 
internal tags other than routine names should cause a tag conflict. If one of your routine 
names conflicts with a routine name in a common deck being used, you should rename your 
routine. 

If you do not wish to rename your routines, you may instead use the following procedure. 

1. Define the tag QUAL$ to turn off automatic qualification of common decks. 

2. Manually qualify the entire common deck (including the routine names) with the QUAL 
pseudo ins true ton. 

For example, to use the space-fill-name common deck COMCSFN, you can use the method shown in 
the following sample program. 
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DUPLICT 



IDENT DUPLICT 
ENTRY DUPLICT 



*CALL 
QUALS 



* 

* 
* 



CONCMAC 
EQU 1 



SUPPRESS AUTOMATIC COMMON DECK QUALIFICATION 



THE *SPACE FILL NAME* COMMON DECK MUST BE QUALIFIED 
BECAUSE THE PROGRAM HAS A SUBROUTINE *SFN* AND THE 
PROGRAMMER DOES NOT WISH TO RENAME THE SUBROUTINE. 



DUPLICT 



SB1 

SA1 

MXO 

SX5 

BX1 

RJ 

SA6 

SX1 

RJ 

SB2 

RJ 

SA6 

MESSAGE 

ENDRUN 



ENTRY 

SET SYMBOL NAME IN MESSAGE 
CLEAR VALUE PORTION OF WORD 
SAVE VALUE 



1 

DUPA 
-18 
X1 + 

XO*X1 y, 

/SFILL/SFN SPACE FILL WORD 

DUPC 

X5+ CONVERT VALUE 

CDD 

3 SHIFT VALUE 3 CHARACTERS LEFT 

SFN — « 



Transfers control to 
COMCSFN, qualified 
by SFILL 



DUPD 
DUPB„R 



ISSUE MESSAGE 



Transfers control to 
the program's shift 
register routine. SFN 



DUPA 
DUPB 
DUPC 

DUPD 

SFN 

** 

* 
* 

* 
* 

* 



CON OLNAME+1 23456 

CON 10H SYMBOL 

CON SYMBOL NAME 

CON 10HHAS VALUE 

CON CONVERTED SYMBOL VALUE 

CON MESSAGE TERMINATOR 

SPACE 4,10 

SFN - SHIFT REGISTER BY *N* CHARACTERS. 

ENTRY (X6> = REGISTER TO SHIFT. 

(B2) = NUMBER OF CHARACTERS TO SHIFT. 

EXIT (X6) = SHIFTED LEFT. 



* 
* 


USES 


B - 2. 
X - 6, 7. 




SFN 


SUBR 




ENTRY/EXIT 




SX7 


B2 


SET NUMBER OF BITS TO SHIFT 




SB2 


B2+B2 






LX7 


2 






SB2 


B2+X7 






LX6 


X6,B2 


SHIFT REGISTER 




EQ 


SFNX 


RETURN 




SPACE 


4,10 




* 


COMMON 


DECKS. 




*CALL 


COMCSYS 






♦CALL 


COMCCDD 








QUAL 


SFILL 


QUALIFY *SFN* 


♦CALL 


COMCSFN 








QUAL 


* 


RESTORE NULL QUALIFIER 




SPACE 


4,10 






END 


DUPLICT 
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The QUAL$ tag can also be used to suppress the qualification of common decks called more 
than once in separate overlays. In the following example, the QUAL pseudo instruction is 
used in each of the two primary overlays; the symbol QUAL$ is used to allow a copy of 
COMCCDD in each overlay without symbol conflicts. 



OVER 



riMrtrr u«ru ma tu y* Til 

A8S 

TITLE MAIN (0,0) OVERLAY. 

ORG 1108 



VLJ mlJJ yvCKL.Hj 



QUALS 



EQU 



1 



SUPPRESS COMMON DECK QUALIFICATION 



* LOAD TWO OVERLAYS - ONE AT A TIME - EACH WILL USE 

* ITS OWN COPY OF *CDD*, BUT WILL USE *SYS=* AND 

* *MSG=* THAT RESIDE IN THE (0,0) OVERLAY. 

MAIN SB1 1 

MESSAGE MAIA„R * MAIN RUNNING.* 

OVERLAY NAIB,0100B LOAD *0VL1* OVERLAY 

SB2 X1 EXECUTE *0VL1* 

JP B2 



MAI1 OVERLAY MAIB,0200B LOAD *0VL2* OVERLAY 

SB2 X1 EXECUTE *0VL2* 

JP B2 

MAI2 MESSAGE MAIC„R * MAIN COMPLETE.* 
ENDRUN END 

MAIA DATA C* MAIN RUNNING.* 

MAIB CON 0LLG0 OVERLAY FILE NAME 

MAIC DATA C* MAIN COMPLETE.* 



•CALL 
♦CALL 



COMCSYS 
COMCOVL 



OVER BSS OVERLAY AREA BASE 

TTL PRIMARY (1,0) OVERLAY. 
EJECT 

QUAL 0VL1 DEFINE QUALIFICATION FOR THIS OVERLAY 

IDENT 0VL1 ,0V1 ,OV1 ,1 ,0 PRIMARY (1,0) OVERLAY 

ORG OVER START AT OVERLAY AREA 
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* 
* 



READ THE REAL TINE CLOCK AND ISSUE A DAYFILE MESSAGE 
INDICATING WHEN OVERLAY WAS CALLED. 



OV1 



RTIME 


OV1A 


GET CURRENT TIME 


SA1 


OV1A 


CONVERT MILLISECi 


MXO 


-36 




BX1 


-XO*X1 




RJ 


CDD 




SA6 


OV1C 




MESSAGE 


OV1B„R 


* OVL1 CALLED AT 


EQ 


HAH 


RETURN 



NNNNNN* 



OV1A CON REAL TIME CLOCK 

OV1B DATA 20H OVL1 CALLED AT 

OV1C CON CONVERTED MILLISECONDS 

CON MESSAGE TERMINATOR 



•CALL 



COMCCDD 



TTL 

EJECT 

QUAL 

IDENT 

ORG 



PRIMARY (2,0) OVERLAY. 

OVL2 DEFINE QUALIFICATION FOR THIS OVERLAY 
OVL2,OV2,OV2,2,0 PRIMARY (2,0) OVERLAY 
OVER START AT OVERLAY AREA 






READ THE REAL TIME CLOCK AND ISSUE A DAYFILE MESSAGE 
INDICATING WHEN OVERLAY WAS CALLED. 



OV2 



RTIME 

SA1 

MXO 

BX1 

RJ 

SA6 



0V2A 

0V2A 

-36 

-X0*X1 

CDD 

0V2C 



MESSAGE 0V2B,,R 
EQ MAI2 



GET CURRENT TIME 

CONVERT MILLISECONDS TO DISPLAY CODE 



* 0VL2 CALLED AT NNNNNN* 
RETURN 



0V2A CON REAL TIME CLOCK 

0V2B DATA 20H 0VL2 CALLED AT 

0V2C CON CONVERTED MILLISECONDS 

CON MESSAGE TERMINATOR 



♦ CALL 



COMCCDD 



END 
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SECURITY CONSIDERATIONS 

A NOS computer system provides extensive protection of information contained in your jobs 
an** nx£3. Ljpeco-x j.caj.j.y , it protects tue central memory associated with your active jobs 
and it enforces job and file access controls. 

MEMORY PROTECTION 

A program cannot dump or directly change the job field length with an RA+1 request if the 
program is one of the following types. 



• 



A user program that has set secure system memory (SSM) status with the SETSSM macro 
(refer to section 6). 



• A user program loaded from an execute-only file. 

The following RA+1 requests can either dump or change the job's field length and therefore 
are not allowed in the types of programs just mentioned. 

Call Description 

CKP Checkpoint request 



DED 



Extended memory field length with display code dump request 



DEP Extended memory field length dump request 



DMB 



Central memory and extended memory field length binary format dump request 



DMD Central memory field length with display code dump request 



DMP 



Central memory field length dump request 



Refer to Volume 3, System Commands, for a list of system commands that set SSM status. 

SYSTEM AND FILE ACCESS CONTROLS 

A NOS computer system operates in either secured or unsecured mode, depending on the option 
selected by your site. On an unsecured system, the primary control of system access is 
based on user names and user passwords. The system further restricts the use of certain 
system resources (for example, applications and special commands) to those explicitly 
granted that privilege by your site. NOS enforces file access controls based on user names, 
file passwords, and permissions granted by the owner of the file. The controls based on 
file passwords and permissions are set at the discretion of the file owner. 

On a secured system, NOS enforces an additional set of access controls based on security 
access levels and categories. These controls limit access to information based on the 
user's authorized clearance level and need-to-know categories versus the security access 
level and category markings associated with each file and maintained by the system. These 
mandatory controls are enforced in addition to the discretionary controls which remain 
available . 

Each user is authorized to use one or more security access levels and zero or more security 
access categories. Every file on a secured system has a single security access level and 
may have one or more access categories associated with it. To access a file, the user job 
must be validated for the file's security access level and for all of the file's access 
categories. 
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SECURITY ACCESS LEVELS 

A security access level limits the disclosure of sensitive information to persons who are 
authorized access to information at the level of sensitivity indicated by that access 
level. A secured system supports up to eight security access levels. The number of access 
levels to be used, the names of those levels, and the degree of sensitivity associated with 
each level are selected by your site. The access levels are ordered so that the least 
sensitive information is associated with the lowest access level and increasingly sensitive 
information is associated with higher access levels . (The access levels have numerical 
values of through 7; the corresponding released default names are LVLO through LVL7.) 
Each user is authorized to use a set of security access levels (normally a contiguous range 
of levels, such as LVLO through LVL4). 

The system associates a set of access levels with each job. This set is the intersection of 
your authorized set of access levels , the range of levels currently valid for the system, 
the range of access levels allowed for your job's origin type, and, if specified by the 
system, the range of access levels allowed over your communication line to the computer. 
For interactive jobs, your job's initial access level is the lowest level in the set of 
access levels for your job. For batch jobs, the initial access level is the access level of 
the local file that initiated the job. 

Example 1: 

You are authorized to use levels LVLO through LVL5, the system is currently validated 
for levels LVLO through LVL7, your job origin type has an access level range of LVL1 
through LVL4, and your communication line has an access level range of LVLO through 
LVL3. As shown in table 1-1, your job will have an access level set of LVL1 through 
LVL3, and the job's initial access level will be LVL1. If this job is initiated via a 
ROUTE or SUBMIT of a local file with access level LVL2, that will be the job's initial 
access level. 



Table 1-1. User Job Access Levels 



















LVLO 


LVL1 


LVL2 


LVL3 


LVL4 


LVL5 


LVL6 


LVL7 


User 

System 

Job Origin 

Communication 
Line 


X 
X 

X 


X 
X 

X 
X 


X 
X 
X 
X 


X 

X 
X 
X 


X 

X 
X 


X 
X 


X 


X 








User Job 




X 


X 


X 
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For a batch job, you can specify an upper access level limit on the Job command. If you 
specify this limit, it must be within the set of access levels the system assigns to the 
job. If you do not specify this limit, the system does not allow the job to run at any 
levs! other than its initial access level. 

Each file has a security access level. Unless you specify otherwise, each file you create 
will have the same access level as your job at the time you create the file. You can raise 
tu6 access xeVei Oi. your txxes \rej.er to the aoxFruj anu vm.^ F/*ju macros j to any level for 
which your job is validated, but you must have special permission to lower the access level 
of your files. The access level of a local file (this includes your primary file but does 
not include tape files or attached direct access files) is automatically raised to the 
current job access level whenever a write operation is performed on the file. The access 
level of tape and attached direct access files cannot be changed while they are assigned to 
your job; an attempt to write on them may constitute a security conflict. Your job's access 
level is automatically raised whenever you read information from a file that has a higher 
access level than your job's current access level (within your job's validated set of access 
levels). You can raise your job's access level using the SETJAL command or macro to any 
level for which your job is validated, but you must have special permission to lower the 
access level of your job. 

Example 2: 

In the job referred to in example 1, you attach a file that has access level LVL3 and 
read information from that file. The access level of your job is immediately raised 
from LVL1 to LVL3. 

Example 3: 

In the same job, you attempt to set your job's access level to LVL5 using the SETJAL 
command or macro; this attempt fails because LVL5 is not in your job's validated set of 
access levels. 

Unless you are specifically authorized, a secured system does not allow you to write 
information from a file with a higher access level into a file with a lower access level. 



Example 4: 



You attempt to copy a portion of a file whose access level is LVL2 to a file whose 
access level is LVL3. A secured system allows this operation. 

Example 5: 

You attempt to copy a portion of a file whose access level is LVL3 to a file whose 
access level is LVL2. A secured system does not allow this operation (unless you have 
special permission). 

On an unsecured system, you may set access levels on your files (for informational 
purposes), but the system does not use those levels to restrict access to the files, nor 
does it propagate those levels to your job or to other files. No job has an access level on 
an unsecured system. 
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SECURITY ACCESS CATEGORIES 

A secured system supports up to 32 security access categories. The number of categories to 
be used and the names of those categories are selected by your site. The access categories 
have numerical values of through 31; the corresponding released default names are CATOO 
through CAT31. Each user is authorized to use a subset of the site-defined access 
categories. Your job's access category set is the intersection of this subset and the set 
of categories currently valid for the system. 

When you create a permanent file (using the SAVE or DEFINE command or macro), the file is 
automatically assigned all of the access categories in your job's access category set. You 
have the choice to explicitly assign all, any, or none of these categories to each of your 
permanent files (refer to the SETPFAC macro). Access categories restrict the access of your 
permanent files to those users who are authorized for all of the categories you have set for 
the files. 

Example 6: 

You are authorized to use the categories CAT01, CAT06, CAT18, and CAT22. You assign the 
categories CAT06 and CAT22 to permanent file ABC, which has an access level of LVL3, 
using the SETPFAC macro. You then make file ABC public. Any user in your family who is 
authorized to use access level LVL3 and categories CAT06 and CAT22 can then access file 
ABC. 

On an unsecured system, you may assign access categories to your permanent files for 
informational purposes, but the system does not use those categories to restrict access to 
the files. 



RESPONSIBILITIES FOR DATA SECURITY 

On a secured system, security access levels and categories are checked whenever a user 
accesses a file, begins a job, or attempts to alter the security parameters of a file or 
job. This ensures that only those persons who are authorized to use the access levels and 
categories you have assigned to your files can access them. A secured system thus provides 
continuous protection of your data. 

Although the system will automatically assign an access level and an access category set to 
each file you create, you are responsible for ensuring that the access level and access 
category set assigned to each of your files is appropriate. Your site should provide 
guidelines for the use of the different access levels and categories it has established. 

All of the NOS security mechanisms depend on the protection of your user password. NOS 
provides the following mechanisms to help protect your password during interactive login: 

• You should always use the secure login procedure described in Volume 3, System 
Commands , to ensure that you are communicating with the system-supplied login 
mechanism. 

• If possible, you should set your terminal to full duplex and enable echoplex mode 
via the network (refer to the terminal definition commands in Volume 3, System 
Commands). The network temporarily disables echoplex when you enter your password 
during login, provided you do not use the abbreviated login sequence. This feature 
prevent? display of your user password at your terminal. 
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SECURITY CONFLICT PROCESSING 

When your job attempts to perform an operation that could violate system security, the 
system identifies the operation as a security conflict and issues a SECURITY CONFLICT 
diagnostic message. A security conflict causes the job step to be aborted and decrements 
your security count (you are given a specific security count by the site security 
administrator). If your security count is decremented to zero, your current job or 
interactive session is terminated, and you are not allowed any additional jobs or logins 
until the security administrator resets your security count. 

On an unsecured system, a security conflict occurs in the following cases: 

• An incorrect secondary USER command . 

• A SUBMIT or ROUTE of a job with an incorrect USER command. 

On a secured system, a security conflict arises in the following cases in addition to those 
listed earlier: 

• An attempt to set an invalid access level on a file or job. 

• An attempt to access one of your permanent files from a job that is not validated 
for the access level or access category set of the file. 

• An attempt to write data on a tape file or an attached direct access file when the 
access level of your job is higher than the access level of the file.t 

• An attempt to set an access level for a file or job which, although valid, is lower 
than the current access level of the file or job.t 



tThis action is not allowed unless you have special authorization to do so. 
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FILE ENVIRONMENT TABLE (FET) 



2 



This section describes the file communication area necessary for file creation and the 
processing of many user requests. The file environment table (FET) is the standard 
communication area or parameter block for the system file processors. The COMPASS 
programmer must define the FET, whereas the higher level languages (COBOL and FORTRAN, for 
example) automatically establish and use this area. 

Depending on the processor being used, certain areas of the FET must be defined and used in 
communicating with that processor. The minimum length of a FET is five words, although many 
processors require a longer FET. 



CIRCULAR BUFFERS 

A circular buffer is a central memory storage area that contains data during input/output 
operations. It is called a circular buffer because routines that process input/output treat 
the first word of the buffer area as if it were contiguous to the last word of the buffer 
area. 

All input/output is performed by passing data between a circular buffer in central memory 
and a peripheral device (mass storage or magnetic tape, for example). 

The buffer pointers FIRST, IN, OUT, and LIMIT define the circular buffer (figure 2-1). 



circular buffer 



first 



file environment table (FET) 



file name 


code out 
status 


parameters 


first 





in 





out 


parameters 


limit 


'V/V/V/V/// parameters V/V/yyV/yy 
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limit 



space for data 




not used 



Figure 2-1. 



Buffer 
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FIRST ADDRESS 

FIRST is the address of the first word of the buffer area. Routines that perform 
input/output never change the value of FIRST. 



LIMIT ADDRESS 

LIMIT is the address of the word following the last word of the buffer area. Buffer data is 

not stored in LIMIT. When LIMIT is reached during a read or write operation, the next word 

to be read or written is FIRST. Routines that perform input/ output never change the value 
of LIMIT. 

The addresses FIRST and LIMIT define the boundaries of the circular buffer. The size of the 
buffer is always (LIMIT-FIRST). 



IN ADDRESS 

IN is the address of the next word of the buffer into which data can be entered. During a 
read operation, the system enters data into the buffer beginning at IN; during a write 
operation, the user program enters data into the buffer beginning at IN. During a read 
operation, the system increments IN as it enters data into the buffer; when IN reaches 
LIMIT, the system immediately resets IN to FIRST. During a write operation, the user 
program must increment IN as it enters data into the buffer, and must reset IN to FIRST when 
IN reaches LIMIT (the data transfer macros described in section 3 increment and reset the 
buffer pointers as necessary for the user program) . 

If, during a CIO operation, IN reaches (OUT-1), or IN reaches (LIMIT-1) and (OUT=FIRST), the 
buffer is full. Because the system enters data into the buffer one PRU at a time rather 
than one word at a time for some CIO operations , the system may consider the buffer to be 
full if it attempts to enter data into the buffer and the buffer contains less than one PRU 
of available space.) 



tThe amount of available space in the buffer is the number of words of data that can be 
entered into the buffer before filling it. If (IN<OUT), the amount of available space is 
(OUT-IN). If (IN>OUT), the amount of available space is (LIMIT -FIRST)-(IN-OUT). 
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Figure 2-2 is an example of a read operation. 
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Figure 2-2. lead Operation 



OUT ADDRESS 

OUT is the address of the next word of the buffer from which data can be read. During a 
write operation, the system removes data from the buffer beginning at OUT; during a read 
operation, the user program removes data from the buffer beginning at OUT. During a write 
operation, the system increments OUT as it removes data from the buffer; when OUT reaches 
LIMIT, the system immediately resets IN to FIRST. During a read operation, the user program 
must increment OUT as it removes data from the buffer, and must reset OUT to FIRST when OUT 
reaches LIMIT (the data transfer macros described in section 3 increment and reset the 
buffer pointers as necessary for the user program). 

If OUT reaches IN during a CIO operation, the buffer is empty. Because the system removes 
data from the buffer one PRU at a time rather than one word at a time for some CIO 
operations , the system may consider the buffer to be empty if it attempts to remove a PRU of 
data from the buffer and the buffer contains less than one PRU of data.t 



tThe amount of data in the buffer is (IN-OUT) if (IN>OUT); if (IN<OUT), the amount of data 
In the buffer is (LIMIT-FIRST)-(OUT-IN) . 



60459690 B 



2-3 



Figure 2-3 is an example of a write operation. 
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Figure 2-3. Write Operation 



FET DESCRIPTION 

There are two basic FET formats. Figure 2-4 illustrates the standard FET for mass storage 
files; figure 2-5 illustrates the standard FET for magnetic tape files. The figures are. 
followed by a description of the FET fields. When a field is used by only one of the file 
processors, it is noted in the description. 
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Figure 2-4. Standard FET for Mass Storage File 
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FET + O 
+ 1 
+ 2 
+ 3 
+ 4 
+ 5 
+ 6 
+ 7 
+10 
+ 11 
+12 
+ 13 
+ 14 
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Figure 2-5. Standard FET for Labeled Magnetic Tape File (CIO and POSMF) 

Refer to the LABEL and OPEN macros for a description of the FET fields used in processing 
ANSI labels. 



Parameter 



Local file name (lfn) 



Word 

(FET+n) 





Level number (In) 



Abnormal termination 
codes (at) 



Position Description 

59-18 The lfn field contains one to seven 
alphanumeric display code characters, 
left-justified; unused characters are 
zero-filled. The lfn is the common 
reference point for all system 
communication concerning the file. 

17-14 This is the level number for an end-of- 
record (E0R)/end-of-f ile (EOF) opera- 
tion on the file. NOS uses this field 
for CIO operations and for distin- 
guishing interactive input from nonin- 
teractive input (refer to CIO in 
section 3 and the discussion on writing 
interactive programs, section 12). 

13-9 Status information returned by the 
function processor when an abnormal 
situation or error occurs. This field 
is usually set by the processor when 
the error processing bit (ep) is set in 
FET+1. For some processors, at is 
returned in bits 17 through 9. This 
field is set to 22 8 by CIO if the ep 
bit is not set and an error condition 
is present. Refer to section 3 for 
the specific error codes returned. 
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Parameter 



Word 
(FET+n) 



Code 



Position 



8-0 



Device type (dt) 



59-48 



Random access (r) 



User processing (up) 



47 



45 



Description 

Reque6t/return code. The user program 
(or macro) sets this code for the 
request desired. The function 
processors alter it only if the request 
is not completed. For example, the 
user program requests a read (CIO code 
010) but encounters an EOR. CIO 
returns a status code of 021. These 
codes are detailed in the function 
processor descriptions (refer to 
section 3). The following are 
subfields for the code parameter. 

Bit 1: file mode (fm). File mode for 
input/output operations on S, L, or SI 
tape formats only. For S or L format 
tapes, bit 1 is: 

Coded 

1 Binary 

Binary mode must be selected for SI 
tape formats or the program is aborted. 

Bit 0: interlock (ilk). FET interlock 
bit. Used to indicate system/user 
access to data associated with the 
file. The user program sets this bit 
to (busy or not complete) and the 
processor sets it to 1 when the request 
is completed. 

The 12-bit display code of the type of 
device on which the file is or will be 
residing (refer to Device Types in 
appendix E). After the file Is 
assigned to a device, the STATUS macro 
or any CIO function enters the device 
type in this field and sets bit 59 if 
the device is a nonallocatable nonmass 
storage device. 

This bit is set if random processing is 
to be performed on the file. If this 
bit is set, the FET must be at least 
seven words in length. 

The user program sets this bit to 
control end-of-reel or end-of-device 
processing. When CIO encounters an 
end-of-reel/end-of-device, it returns 
an abnormal termination code of 2 (bits 
13 through 9 of FET+0). For further 
information about end-of-reel 
processing, refer to the CIO CLOSER 
macro description. 
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Parameter 



Error processing (ep) 



Word 
(FET+n) 



Position 



44 



Description 

This bit is used to indicate to the 
function processor that the calling 
program processes errors that occur, 
such as parity errors or errors in 
requests to the file managers. The 
function processor returns the error 
code to the at field of FET+0. Refer 
to the section of this manual relating 
to the specific processor called for 
descriptions of the error codes 
returned. If this bit is not set, the 
function processor either aborts the 
job or requests operator intervention. 

If an unrecovered parity or block too 
large error occurs during a magnetic 
tape read operation (with the ep bit 
set) or if a read parity error occurs 
on a mass storage read operation (with 
ep bit set), the system performs the 
following steps. 



1. The data in the bad block is 
stored in the user program's 
circular buffer. 

2. The value of the IN pointer 
prior to the read is stored in 
the next word in the circular 
buffer (pointer to the 
beginning of the bad data 
block) . 

3. The parity error code is set in 
FET-K). 

4. The IN pointer is updated in 
the FET. This IN pointer value 
does not include the additional 
word (pointer to the beginning 
of the bad data block) stored 
in the buffer. 

5. The FET completion bit is set. 

The pointer to the bad data is returned 
on all reads processed by CIO for a 
mass storage file. If no data is 
transferred (correct PRU not read) , the 
pointer points to itself, and no update 
of IN occurs. 

If tape error processing is inhibited 
(refer to the LABEL macro, section 4), 
the preceding steps are not performed 
regardless of whether or not the ep bit 
is set. 
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Word 
Parameter (FET+n) Position Description 

Extended label 1 41 Specifies standard (xl=0) or 

processing (xl) extended (xl=l) tape label processing. 

Access level 1 39 If this bit is set, the file's security 

bit (a) access level is to be taken from or 

returned to the al field in FET+4. 

Flush bit (fb) 1 36 If this bit is set, the file's circular 

buffer is to be flushed upon abnormal 
termination or for terminal files when 
the job is rolled out. 

Files that are pointed to by the list 
of files (refer to the SETLOF macro, 
section 6) and meet the following 
criteria are flushed with the 
appropriate write function. 

• Original error flag (ef) is 
less than SPET (refer to EREX1T 
macro, section 6). 

• No buffer parameter errors; 
that is, the entire FET must be 
within the job's field length 
as follows: 

LIMIT. LE.FL 

OUT. LT. LIMIT 

OUT.GE. FIRST 

IN. LT. LIMIT 

IN. GE. FIRST 

• The code field of the FET is 
set to one of the valid 
function codes that enable 
implicit terminal output (refer 
to table 3-1). 

• No CIO error code is present in 
the FET. 

• Data is in buffer. 
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Parameter 



Word 
(FET+n) 



Position Description 

At the end of the job step, files are 
flushed with an end-of-record write 
(CIO function 024) unless the last 
function in the FET is a WRITECW (204) 
ui HR.AAM1 \£s><* > s in wmcn case ttiat 
function is reissued. The FET status 
is not changed for implicit terminal 
output, but the action taken by the 
system is the same as if a buffered 
write (CIO function 14 or 16) had been 
issued. 



NOTE 



Care must be taken when select- 
ing random files to be flushed 
since they could be truncated 
by an end-of-record write. 



FET length (len) 



first 



in 



23-18 Specifies the additional length of the 
FET beyond normal size (five words). 
For example, if len = 3, FET length = 
10g and FET+7 is the last usable 
word. Function processors require 
varying lengths for particular 
parameters. 

17-0 First word address of input/output 
buffer (FIRST address). 

17-0 The next available location for 

entering data into the buffer (IN 
address). The upper 42 bits should 
never be used since the function 
processors read and write the entire 
word. 



out 



FNT pointer 



17-0 The next available location for 

removing data from the buffer (OUT 
address). The upper 42 bits should 
never be used since the function 
processors read and write the entire 
word. 

59-48 Relative address of the local file name 
table (FNT) entry for the file. The 
system uses this pointer to reduce 
overhead when processing a file. 
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Parameter 



Word 
(FET+n) 



al 



PRU size 



fwa working storage 



lwa+1 working storage 



la 



Position Description 

38-36 The numerical value of the file's 

security access level. (You can use 
the system OPL common deck COMCVLC to 
convert access level names to the 
corresponding numerical values, and 
vice versa. ) 

35-18 Number of central memory (CM) words in 
a physical record unit (PRD) for the 
device to which the file is assigned. 
The PRU size for mass storage is always 
100g CM words. The PRU size for 
magnetic tape varies according to the 
data format selected. Refer to 
appendix J for information on magnetic 
tape PRU size. 

This field is set only if the file is 
opened using the CIO OPEN macro. 

17—0 Last word address plus I of the buffer 
(LIMIT address). Data is never placed 
in or removed from LIMIT. 

47-30 First word address of working storage. 
Working storage is used by several of 
the compilers to control input/output 
in specific formats (blocking/unblock- 
ing). This parameter is not used by 
the system or the NOS common decks that 
refer to working storage areas. 
Working storage areas for use by macros 
(READS, READC, and so forth) require 
the user program to define its own 
working storage area and specify this 
area on each macro request. Pointers 
to working storage can be placed here 
for reference. 

17-0 Last word address plus 1 (LWA+1) 
of working storage. 

17-0 List address (CIO READLS and RPHRLS 

macros only). This points to the table 
of relative sector addresses. 



Current random Index 
(cri) 



59-30 The current random index for the mass 
storage file being randomly accessed. 
The system returns the current position 
of the file after a random input/output 
request. This index is in the form of 
a relative sector address (rsa) from 
the beginning of the file. For any 
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Parameter 



Word 
(FET+n) 



Position 



Description 



Random rewrite 
request (w) 



29 



Unused bit count (ubc) 



Random request (rr) 



29-24 



28-0 



Maximum logical record 
size (mlrs) 



Index length (il) 



17-0 



35-18 



Index first word 
address (if) 
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17-0 



nonrandom read or writ a «-*T*^-»-.a «•■?/**» «-^ n 
system updates this field by adding the 
number of sectors transferred to the 
existing contents of the field. For 
any ranucm access or positioning 
operation, the value is recalculated, 
cri is ignored if r (FET+1) is not set. 

This bit is set to indicate a rewrite- 
in-place operation for one of the 
following functions: WPHR, WRITE, 
WRITER, WRITECW. If rrjtO and this bit 
is not set, the write takes place at 
E0I with rr being used for the address 
for the return of rsa, where the write 
began. If w=0 and rr=0, a sequential 
write is performed at the current 
position of the file. This bit is 
ignored if r (FET+1) is not set. 

Specifies the unused bit count for S 
and L format tapes (refer to 
appendix J) . 

Relative sector address (rsa) for a 
random input/output request. An 
exception is that if w=0 and the 
request is a write request, then rr is 
the address for the return of the 
starting rsa of the write (previous 
EOI). 

If the error processing bit (FET+1, bit 
44) is set and an error occurs on a CIO 
request, the system returns detailed 
error status information to bits 11 
through 0. For further Information, 
refer to the description of CIO in 
section 3. rr is ignored if r (FET+1) 
is not set. 

Specifies the maximum physical record 
size for S and L format tapes. Refer 
to appendix J. 

Random index length. This must be set 
by the user program when requesting CIO 
OPEN to load the random index of a file 
or CIO CLOSE to dump the random index 
of a file. If r (FET+1) is not set, il 
is ignored. 

First word address of the index buffer. 
This is the area where CIO OPEN stores 
the index when opening a file or the 
area from which CIO CLOSE takes the 
index when closing a file. If 
r (FET+1) is not set, if is ignored. 
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Parameter 



File identifier 



File identifier 



File sequence number 



Generation version 
number (gvn) 



Retention cycle 



Creation date 



Set identification 



File section number 



Word 
(FET+n) 

118 



12 8 



12p 



13 8 



138 



138 



14 8 



14 8 



Position Description 

59-0 File identifier (first 10 display code 
characters, left- justified with display 
code blank fill).f 

59-18 File identifier (last seven display 
code characters, left- justified with 
display code blank fill) . f 

17-0 One- to three-digit numeric display 
code file sequence number 
(right- justified with display code zero 
filD.t 

59-48 One- or two-digit numeric display code 
generation version number 
(right-justified with display code zero 
filD.t 

47-30 One- to three-digit numeric display 

code retention cycle (right- justified 
with display code zero fiii).t 

29-0 Creation date (two-digit numeric 
display code value for the year 
followed by a three-digit numeric 
display code value for the day within 
the year).t 

59-24 One- to six-character set 

identification (left- justified with 
display code blank fill).t 

23-0 One- to four-digit numeric display code 
file section number (right-justified 
with display code zero fill).t 



The r, w, and rr FET parameters affect file manipulation operations as shown in table 2-1. 
The effects of these parameters depend on the type of operation (read, write, or rewrite) 
being performed. 



tRefer to the HDR1 label in Volume 3, System Commands. 
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Table 2-1. Effects of r, w, and rr FET Parameters on File Manipulation Operations 



NOTES: 
r=l 



FET Bits 



^0 



ru 



NR 



Operation 



3 

cau , 

write , and 
rewri te 

Read 



Write 
Rewrite 

Read 
Write 

Rewrite 
Read 

Write 
Rewrite 

Read 

Write 

Rewrite 



Definition 






Reads from current position (same as sequen- 
tial except cri is returned). 

Sequential write is performed. 

Random write at current position is per- 
formed . 

Random read from rr is performed. 

Write is performed at current E01 (position 
of file before write returned at address 
specified by rr) . 

Random write or rr is performed. 

Reads from current position (same as 
sequential except cri is returned). 

Sequential write is performed. 

Random write at current position is per- 
formed . 

Random read from rr is performed. 

Random write at rr is performed. 

Random write at rr is performed. 



A random operation can be performed. The system returns the current 
random index (cri) in FET+6 (position of file when the operation is 
complete) . 



Sequential write Writes at current position; data is followed by an EOI. 



Random write 



Writes data without an EOI at the end (the remainder of the file, the 
portion following the data written, is not released). 

R means value is returned; NR means value is not returned. 
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FET CREATION MACROS 

The following four macros initialize FETs . They can be used to create sequential coded 
files, sequential binary files, random coded files, and random binary files. 



FILEB 

The FILEB macro creates a FET for a binary sequential file. 
Macro format : 

Location Operation Variable 



lfn 



FILEB 



fwa, length, p 1 ,p 2 ,...,p n 



FILEC 

The FILEC macro creates a FET for a coded sequential file. 
Macro format: 

Location Operation Variable 



lfn 



FILEC 



fwa,length,p 1 ,p 2 , . . . ,p n 



RFILEB 

The RFILEB macro creates a FET for a binary random file. 
Macro format : 

Location Operation Variable 



lfn 



RFILEB 



fwa,length,p 1 ,p 2 , . . . ,P n 
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RFILEC 

The RFILEC macro creates a FET for a coded random file. 
Macro format: 

Location Operation Variable 



lfn 



RFILEC 



f wa, length, p x ,p 2 , • • • ,P n 



The following parameters apply to each FET creation macro. 

lfn Local file name and address of FET. 

fwa First word address of CIO buffer. 

length Length of the CIO buffer. Because the buffer is full when (IN=0UT-1) or 
(IN=LIMIT-1) and (0UT=FIRST), the buffer length should not be an exact 
multiple of PRU size. The following are the minimum and recommended buffer 
sizes for mass storage, tape, and terminal input/output. 



Device 



Mass storage 



Minimum (Octal) 

101 (without 
control words t) 

103 (with 
(control words) 



Recommended (Octal) 
1001 to 2001 (without control words) 

1021 to 2041 (with control words) 



Tape 1001 (without 

(I and SI binary control words) 
tape formats) 

1003 (with 
control words) 



3n+l to 4n+l , where : 

n=1000 (without control words) 
n~I002 'with control w^ 1 *'' ^ 



Terminal 



101 for input 



301 for output 



(larger sizes are 
recommended for 
terminals with 
line speeds above 
1200 baud) 



Refer to appendix J for a description of PRU sizes for S, L, and F tape 
formats. 



t Refer to the CIO READCW (200) request for a description of control words. 
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Pi 



The following parameters can be used to set fields in the FET. They can be 
specified in any order. 



Parameter 
DTY=dt 

EPR 

FET=len 1 

IND=addr,len2 

LBL 
UPR 
WSA=addr,len 3 

XL 



Description 

Sets the device type to dt. The user program must 
specify display code equivalent of dt. For example, 
set device type to TT by specifying DTY=2RTT or 
DTY=2424B. Refer to appendix E for legal device types. 

Sets the error processing bit (FET+1, bit 44). 

Sets the length of the FET to lenj. 

Sets the index first word address to addr and the 
index length to len2. 

Sets the FET length to 15g for tape label processing. 

Sets the user processing bit (FET+1, bit 45). 

Sets the first word address of working storage to addr 
and the length of working storage to len3. 

Sets the extended label processing bit (FET+1, bit 41) 
and sets the FET length to 15s. 



The following parameters are used for setting PFM communication words (refer to section 5) 
in the FET. 

PFN=pfn Sets the permanent file name in FET+lOg to pfn. 

USN=un Sets the alternate user name in FET+1 lg to un. 

PWD=pwd Sets the permanent file password in FET+12g to pwd. 

UCW=ucw Sets the user control word (bit 59 must be set to indicate that the word 
contains user control information) in FET+1 3g to ucw. 

PKN=pn Sets the pack name for access to permanent files residing on auxiliary 
devices in FET+14g to pn. 

The following example illustrates the use of FET creation macros to create a FET for 
sequential input/output operations. 

BUFL EQU 2001 B 

TAPE1 FILEB BUF,BUFL, (FET=7) 

BUF BSS BUFL 
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The following example creates a FET for retrieving a file from permanent file storage; 

loading the index block, and performing random input/output operations. 

BUFL EQU 2001 B 

INDXL EQU 100B 

TAPE1 RFILEB BUF,BUFL,(FET=10D),(PFN=ST0CKS), UND=INDX,INDXL> 

BuF BSS 3UFL 

INDX BSS INDXL 



FET MODIFICATION MACRO 

The SETFET macro modifies specified fields in a FET during program execution. 
Macro format :t 

Location Operation Variable 

SETFET addr,pi,P2 p n 

addr Address of FET to be modified. 

p^ Parameters specifying fields in the FET to be modified. 

The following parameters can be used to modify fields in the FET. They can be specified in 
any order. 



I KIQTF I 

SETFET does not verify that the modified 
words are within the FET length. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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BUF=fwa .length 
DTY=dt 



ERA=erad 



ERP=erp 



LFN=lfn 
PFN=pfn 

PKN=pn 

PWD=pwd 

UCW=ucw 

USN=un 



Description 

Changes the first word address of the CIO circular buffer to 
fwa and the length of the buffer to length. Thus, FIRST, IN, 
and OUT are changed to fwa and LIMIT is changed to fwa+length. 

Changes the device type to dt. The dt option is the display 
code equivalent of the device type, right- justified with 
binary zero fill in a register or a central memory location 
as described in SETFET Parameter Processing. Refer to 
appendix E for legal device types. 

Changes the error message return address to erad for PFM 
requests (refer to Error Processing in section 5). 

Sets the error processing, user processing, or real-time 
processing bit , or combinations of the error and user 
processing or error and real-time processing bits. The erp 
option can be a mnemonic as follows . 

Description 



Set user processing bit at FET+1, 

bit 45. 

Set error processing bit at FET+1, 

bit 44. 

Set real-time processing bit for PFM 

requests at FET+1, bit 43 (refer to 

section 5). 

Set both user processing bit and error 

processing bit. 

Set both error processing bit and 

real-time processing bit. 



If an erp other than those listed is specified, it must be a 
register or central memory location containing the value of 
erp (refer to SETFET Parameter Processing). 

Changes the local file name in FET+0 to lfn.t 

Changes the permanent file name in FET+1 O3 to pfn for PFM 
requests. t 

Changes the pack name in FET+14g to pn for PFM requests. t 

Changes the password in FET+12g to pwd for PFM requests. t 

Changes the user control word in FET+1 3g to ucw for PFM 
requests (bit 59 of ucw must be set if this field is to be 
used on a CHANGE request ).t 

Changes the alternate user name in FET+llo to un for PFM 
requests. f 



erp 


Value 


U 


4 


E 


2 


R 


1 


UE 


6 


ER 


3 



?This option is left-justified with binary zero fill in an X register or central memory 
location as described in SETFET Parameter Processing. 
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SETFET PARAMETER PROCESSING 

For the DTY, ERP (when mnemonics are not used), LFN, PFN, PKN, PWD, UCW, and USN parameters, 

f-Vio -Fnl 1 /Mj-fno Till AQ nr»nlT7_ 
*-">- —«———"— « -.———- — rr — j . 

• If an option is represented by a register, the register contains the value to be 
placed in the FET. For example: 

SETFET F,(LFN=X4) 

uses the contents of X4 as the new local file name. 

• If an option is represented by a constant, the constant specifies the address 
containing the value to be placed in the FET. For example: 

SETFET F,(LFN=LOFN) 

uses the contents of location LOFN as the new local file name. The file name can be 
specified in a literal as follows: 

SETFET F,(LFN=6L0UTPUT) 

• If an option is a register that is preceded by the number sign (#),* the register 
specifies the address containing the value to be placed in the FET. For example: 

SETFET F,#B3 

uses B3 as the address containing the value to be placed in the FET. 

e If an option is a register expression or constant preceded by the number sign, it 
specifies the address containing the address of the value to be placed in the FET. 
For example: 

SETFET F,(LFN=#FADDR) 

uses the contents of FADDR as the address containing the value to be placed in the 
FET. 

For the BUF and ERA parameters, the following rules apply. 

• If an option is represented by a register, the register contains the value to be 
placed in the FET. For example: 

SETFET F,(ERA=A5) 

uses the contents of A5 as the new error message return address . 

• If an option is represented by a constant, the constant specifies the address value 
to be placed in the FET (not the address containing the value). For example: 

SETFET F,(ERA=ERRBUF) 

uses the address ERRBUF as the new error message return address. 



tThe equivalence sign (=) in the CDC graphic character set (display code value 60g). 
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SETFET EXAMPLES 

Example 1 : 

The SETFET macro can be used to take advantage of the way in which FORTRAN passes 
parameters to subroutines. Assume a FORTRAN program calls a COMPASS subroutine GETF to 
retrieve a permanent file. The call accepts three parameters to select the local file 
name , permanent file name , and file password : 

CALL GETF(lfn,pfn,pwd) 

When FORTRAN processes the call, it builds a central memory table with one entry for 
each parameter, terminated by a zero word. The entry contains the actual address of the 
parameter. Before control is passed to the subroutine, FORTRAN sets the Al register to 
the first word address of the table. Thus, XI contains the address of the first 
parameter . If the call to GETF is : 

CALL GETF (DATA1, BASE 1.PWD1) 

the Al register is the first word address of the table of addresses, XI contains the 
address of DATA1, location Al+1 contains the address of the next parameter, and so on. 
The following SETFET macro call uses the contents of the table to build a FET. 

SETFET F, <LFN=#X1 ) , (PFN=#A1 +1 ) , CPWD=#A1 +2) 



F FILEB BUF,301B(FET=16D> 

BUF BSS 301B 



Example 2 : 

Similarly, a COMPASS program could place the values in the FET as follows! 

SA1 DATA1 
SB3 BASE1 
SETFET F,(LFN=X1),(PFN=#B3),(PWD=PWD1) 



DATA1 DATA 0LDATA1 

BASE1 DATA 0LBASE1 

PWD1 DATA 0LPWD1 

F FILEB BUF,301B,<FET=16D) 

BUF BSS 301B 
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INPUT/OUTPUT 



This section describes the process of performing input/ output (I/O) from a COMPASS program. 

This section is divided into two parts, combined input/output (CIO) and data transfer. The 
CIO part includes those macros needed for file creation, read and write functions, and file 
positioning. The data transfer part includes those macros that allow the user program to 
transfer information between the circular buffer and a working buffer area. 

The user program can perform I/O directly through FETs using CIO or with CYBER Record 
Manager facilities that are available to COMPASS users through COMPASS macro calls. A brief 
description of CYBER Record Manager features is provided later in this section. 



COMBINED INPUT/ OUTPUT (CIO) 

The CIO read/write requests are used to transfer data between a file and a CIO circular 
buffer. The read requests transfer input files from a system storage medium to a CIO 
circular buffer. The write requests transfer output from a CIO circular buffer to a system 
storage medium. Also included in this group of requests are those which open and close 
files, those which update records in an existing mass storage file, and those which control 
positioning of the file. 

The format of the call to CIO is: 



59 



RA+1 



40 35 



CIO 



SM 



17 



addr 



addr 



Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 

Count for skip operations. 

Address of the FET. 
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Word FET+0 contains the following information. 



59 



17 13 



FET+O l*n 



In 



at 



code 



lfn Local file name. 

In Level number (CKln<17g) for an EOR/EOF operation on the file: 

Level Number Description 

EOR operation. 
1-1 63 Same as level 0. 
17g EOF operation. 

at Abnormal termination code returned by CIO: 

Code (Octal) Description 

01 End of information encountered. 

02 Device full/end of reel encountered. 
04 Parity error. 

21 End of multifile set. 

22 Fatal error. 

23 Random index too large for index buffer on OPEN. 

code Request/return code: 

Bit(s) Description 

8-2 Individual return code from a CIO function. Refer to 
the specific function for the bit settings and their 
meanings. Table 3-1 contains a summary of these codes. 

1 File mode bit. Binary operation if set (applies only to 
SI, S, and L format tapes); coded operation if zero 
(applies only to S and L format tapes). 



NOTE 



Binary mode must be selected for SI format 
tapes or the job will abort. 



Completion bit; indicates operation complete if set, 
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The file mode (fm) bit, bit 1 of FET+0, is not actually part of the status response, 
although it is returned as such. The fm bit is used by tape drivers, in some cases, to 
determine parity (seven-track) or whether conversion is required between character sets 

/•«-r-««_*-*-«/»L-\ TPsiv A-ieV T I C\ *-Tio \\1 t- la narvi aA fnr r*rimT»af--fh-? 1 1 +--w t.t(*-1i f ano T/A "Vm!*- 4 o 

meaningless. The bit is set by the FILEB or FILEC macros or directly by the user program. 
After this it is retained as part of the return code. 

The CPU program is expected to issue an even request code (bit 0=0). If it does not, a 
completed operation may not be detected. 

CIO uses FET+5 and FET+6 in the following manner. 



FET +5 
+6 



1«««1« 


la 


>yyyyyyyyy/////?///////////A 


ubc Y///// 


mlrs 


en 


w| rr/dec 



Imagnetic tape t 
(mass storage 



la 

ubc 
mlrs 
cri 
w 



dec 



Address of a list of random addresses to be used with READLS or RPHRLS 
mass storage operations. 

Unused bit count for S and L format tapes. 

Maximum PRU size for S and L format tapes. 

Current random index (for mass storage files only). 

Random rewrite request (for mass storage files only) . 

Random request (for mass storage files only): if rr^O, and the request 
is a read request, rr is the random index. 

If rr?^0, w=0, and the request is a write request, rr is the address for 
return of random index (the write operation begins at the current EOI) . 
The index of the EOI prior to the write is returned to the calling 
program. 

If rr^O, w=l, and the request is a write request, rr is the random index 
indicating where the write will begin. 

Detail error return code (for mass storage files only). 

Code Type of Error 

xOOl Parity error. 

x002 Address error. 

x003 Device status error. 

x004 6681 function reject or function set to mass storage 

device that timed out with no response. 

x005 Device reserved. 

x006 Device not ready, 

4007 Track limit (device full). 



TThese fields apply only to S and L format tapes. 
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If, after a read error (with ep bit set), the system determines that the 
correct PRU was read (although it may contain incorrect data) then x 
above is set to 0, the data is placed in the buffer, and the file is 
positioned to the next PRU of the file. If the correct PRU is not read, 
then x is set to 4, no data Is placed in the buffer, and the file is not 
repositioned. The cri is set as usual. 

Equipment that may be accessed by CIO includes: 

• Mass storage. 

• Magnetic tape units. 

• Terminals. 

CIO FUNCTION PROCESSING 

All of the CIO macros require the following two common decks for system interface. 

• C0MCCI0 

• COMCSYS 

These common decks are available to you in relocatable form on the user library SYSLIB. 

If a CIO macro specifies a FET that currently does not have the completion bit (bit of 
FET+0) set, common deck C0MCCI0 will wait (by performing recalls) for completion before 
performing the specified function. 

Error processing for functions issued to CIO involves processing only those errors that 
occur on the specified devices which include read and write parity errors to magnetic tape. 
If a mass storage device returns an error status or the device driver detects an error, the 
system places the error status in the at (abnormal termination) field of FET+0. If the 
error processing bit is set in the FET+1 ep field and the FET length is greater than six, a 
detail error code is returned to the user program in the FET+6 dec field. 

Table 3-1 lists the status response codes returned for the CIO functions, and shows which 
functions have the following properties: 

• The system verifies the FIRST and LIMIT circular buffer parameters during the CIO 
operation. 

• The system verifies the IN and OUT circular buffer parameters during the CIO 
operation. 

• The system sets the IN and OUT circular buffer parameters to FIRST during the CIO 
operation (emptying the circular buffer). 

• The function can only be performed on a file residing on a mass storage device. 

• The function can only be performed on a file residing on a magnetic tape device. 

• The function can be performed on a file residing on device type TT (assigned Lo an 
interactive terminal). 
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• The function can be performed on a file residing on device type NK- 

• The data in the circular buffer of the file whose FET has the specified function 
will be printed at the terminal upon job step abort or job rollout if the file is 
included in a list of files in RA+2 or in a list specified in a SETLOF macro 
(refer to SETLOF macro description in section 6), and if the file is assigned to 
device type TT. 

• The function can be performed on an execute-only file. 

The status response codes shown in table 3-1 are returned the lower 18 bits of FET+0, Only 
those bits needed to distinguish the codes are shown; for example, 021 indicates xxx021 in 
bits 17 through of FET+0, where xxx can have any value. The meanings of the status 
response codes are as follows : 

Meaning Code ( s)t 

EOR encountered 021 

EOF encountered 740031,740271 

EOI encountered 741031,741271 

Rewind 051 



tThese codes are returned for a coded FET. The codes for a binary FET end in 3 instead 
of 1 (refer to the description of the code field of FET+0 at the beginning of this 
section) . 
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Table 3-1. CIO Function Status Response Codes and Processing Options 



CIO Function 


Function Code 


Status 
Response 

Codes t 


Verify 
FIRST, 
LIMIT 


Verify 

IN, 

OUT 


Set IN- 

OUT- 

FIRST 


Haas 

Storage 

Only 


Magnet- 
ic Tape 
Only 


Valid 
on 

Equip. 
Type TT 


Valid 
on 

Equip. 
Type NE 


Valid 

for 

Implicit 

Terminal 

Output 


Can be 

Issued 

on 

Execute 

Only 

File 


RFHR 


000 


021,740031,741031 


X 


X 








X 


X 


X 




READ, READ-SKIP 


010,020 


021,740031,741031 


X 


X 








X 


X 






WRITE PRU 


004 


' 


X 


X 








X 


X 


X 




WRITE, WRITE EOR, 
WRITE EOF 


014,024,034 




X 


X 








X 


X 


X 




BACKSPACE 


040 


051,740041 












X 


X 




X 


BACKSPACE PRU 


044 


051 












X 


X 




X 


REWIND 


050 




X 




X 






X 


X 




X 


REWIND 


054 




X 




X 






X 


X 




X 


UNLOAD 


060 














X 


X 




X 


RETURN 


070 














X 


X 




X 


OPEN/READ 


100/300 




X 










X 


X 






OPEN/WRITE 


104 




X 










X 


X 


X 




POSITION 
MLi/tlr ILe, 


iiO 




X 








X 










EVICT 


114 














X 


X 




X 


OPEN ALTER 


120 




X 










X 


X 


X 




CLOSE 


130/330 














X 


X 






OPEN READ REWIND 


140/340 




X 










X 


X 






OPEN WRITE REWIND 


144 




X 










X 


X 


X 




CLOSE REWIND 


150/350 




X 










X 


X 






OPEN ALTER REWIND 


160 




X 










X 


X 


X 




CLOSE UNLOAD 


170/370 














X 


X 






CLOSE/CLOSER RETURN 


174/374 














X 


X 






READ CONTROL WORDS 


200 


740031,741031 


X 


X 










X 




: 


WRITE CONTROL WORDS 


204 




X 


X 










X 






READ WITH LIST 


210 


740031 


X 


X 




X 






X 






REWRITE, REWRITER, 
REWRITEF 


214/224/234 




X 


X 




X 






X 






READ PRU WITH LIST 


230 


740031 


X 


X 




X 






X 






SKIP RECORD FORWARD 


240 


740271,741271, 
261 












X 


X 




X 


OVERWRITE 


244/254 










X 












READ TO EOF 


250 


740031,741031 


X 


X 








X 


X 






READ CONTROL WORDS 
S/L TAPE 


260 


740271,741271 


X 


X 






X 










WRITE CONTROL WORDS 
S/L TAPE 


264 




X 


X 






X 










READ TO EOI 


bOO 


741031 


X 


X 








X 


X 






SKIP RECORD BACKWARD 


640 


740051,740641 












X 


X 




X 


tThese codes are returned for a coded FET; the codes for a binary FET end in 3 instead of 1 (refer to the description of the code field of FET+O at the 
beginning of this section). The status codes for normal completion of a request are not shown. The status code for normal completion is identical to 
the function code, except that bit of the field is set to indicate completion; for example, 261 is the status code for normal completion of function 
code 260. 
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ACCESSING FILES 

The two methods used to access files assigned to a job are sequential and random access. 
Any file can be accessed sequentially; however, only mass storage files can be accessed 
randomly. When reading a file sequentially, the user program (or the system) reads all the 
information in the file from the current position to the end of the desired portion of the 
file. 

When reading a file randomly, the user program (or the system) reads only the desired 
portion of the file. Any mass storage file can be read randomly if the relative position, 
from beginning-of- information (BOI), of the PRU to be read is known. The desired PRU can be 
read by placing the PRU number in the FET and making the proper I/O requests. The random 
address of a PRU is the number of PRUs that precede the PRU on the file. The first PRU that 
can be read or written is PRU 1. PRU on all mass storage files is reserved for system use. 

Several methods of random processing exist. The specific method depends on the language 
being used; however, the following rules apply in all cases. 

• Most random I/O operations require a directory or index that contains the random 
disk addresses of records in the file. 

• An EOR or EOF I/O operation transfers one PRU for the EOR or EOF. 

• When randomly rewriting data within a file, the user program must take steps to 
ensure that data following the area to be written is not destroyed. 

Figure 3-1 illustrates a typical example of the structure of a random access file. Record 3 
has random address 5. The first random address that can be read or written is address 1. 
The first PRU (for mass storage, a PRU is equivalent to a sector) on all mass storage files 
is reserved for system use . 




record 3 



record 4 • 



PRU 



system information 





word count :100s 


1 


word count = 36 a 


2 


word count = 12 g 


3 


word count =0 


4 


word count :100s 


5 


word count :12 s 


6 


word count = 100s 


7 


word count =100 g 


10 


word count :12 a 


11 


directory (word eoant=30g) 12 


13 


14 



BOI 

EOR 
EOR 
EOF 

EOR 



EOR 
EOR 
EOF 
EOI 



word 








* 


identifier 
table 




* 






• 










• 






17 




• 






20 


record 1 




136 8 


1 


22 


record 2 




12 8 


3 


24 


record 3 




112 8 


5 


26 


record 4 




212 8 


7 




t 










record length 


random address 



The directory can be built in any 
format. This is a typical example. 



Figure 3-1. Sample Random Access File Format 
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READING FILES 

To read record 3 sequentially, the user program rewinds the file to BOI, reads the file, and 
counts the number of EORs. CIO file positioning macros can be used to skip records 1 and 2; 
however , the primary consideration Is that the data must be read to determine where record 3 
begins. Once this is determined, record 3 can be read. 

If a directory exists for this file, the only requirement is that the random address of 

record 3 be obtained from the directory and placed in the FET. The proper random read 

requests can then be issued. To perform this random read on record 3, the following steps 
are required. 

• Skip to the EOI. This is done by the system without reading the entire file. 

• Backspace two logical records (one record for the EOF and one for the directory). 
The system must read both records to perform this operation. 

• Read the directory to obtain the random address to be placed in the FET. 



NOTE 



An EOF may or may not be present at the end 
of the file. The language and methods used 
to build the directory determine whether an 
EOF is present. If an EOF is not present, 
the directory can be read in automatically 
by specifying an index buffer on an OPEN 
request. 



In summary, to access record 3 sequentially, four additional PRUs must be read. To access 
the record randomly, only three additional PRUs are read: two PRDs to position the file to 
the directory and one PRU to read the directory. 

For additional random accesses to any record in the file, It is not necessary to access the 
directory again if it remains in central memory. 

Each directory entry contains the record name, the first PRU of the record (random address), 
and the record length. The directory can be placed anywhere in the file. The only 
requirement for accessing a file randomly is that you must know where to position the file 
in order to read the directory. However, the directory usually precedes the EOF/EOI. 



WRITING FILES 

After reading and modifying record 3 of the sample file, the user program may rewrite the 
record in the file. If the modifications have not changed the number of PRUs required, a 
write operation can be used to replace the existing record with the modified record. This 
write operation must be issued as a random I/O operation. However, if the modifications 
have changed the number of PRUs required, data following the record being written is lost. 
For example, the size of record 3 in the sample file Is 112g words or two PRUs. A maximum 
of 658 wor ds can be added to the record without requiring an additional PRU and destroying 
data. If a random write request that adds 65g words to record 3 is issued, the file would 
have the following format. 
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record 3 



word count = 


4 


word count =100 a 


5 


word counts 7 7g 


6 


word eount = 1 00 g 


7 


10 


11 



EOR 



This operation is called a rewrite in place. If the write had been issued as a nonrandom 
write operation, the file would have had the following format. 



record 3 



word count* 


4 


FOF 


word count = 100 g 


S 




word count: 7 7g 


6 


EOR 


7 


EOT 



All data following the inserted data would have been destroyed. If the word count for 
record 3 had been increased to 212g, a random rewrite could not have been performed 
without destroying PRU 7. The file would then have the following format. 



record 3 



word count: o 


4 


word count: 1 00 g 


5 


word count OOOg 


6 


word count = 12 g 


7 


10 


11 



EOF 



EOR 



To properly rewrite record 3 without destroying the contents of PRU 7, the user program 
could issue a write request at the end of the file and alter the directory to reflect the 
change. Figure 3-2 illustrates the updated file containing the new directory and the 
212g-word modified record 3 written at the end of the file. 
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PRU 














record 1 1 
record 2 | 

record 4 

record 3 - 


BO I 


EOR 
EOR 


word count= 100 8 


word count :36g 2 


word count =12 8 3 


word count: 4 


word 
EOF 




^$^word .cou„,=,00^5 v 


EOR 

EOR 

— 




s 

17 
20 

22 

24 
26 


7000 0016 0- 




* 




$^!«£**')?»!$$& 


identifier 
J table ' 

• 
• 
• 


word count = 100 8 7 


word count = 1 00 g 1 ° 


word count ^ 12 g ■■ 


record 1 


^^^k^M* 


136 8 


1 


word count =0 " 


EOF 
EOR ) 


r~ 


record 2 


word count = 100g '* 


12 8 


3 


word count = 100g ' 5 


record 3 


word count =12 g "* 


212$ I 14 8 


directory (word count « 30 g) 17 


} word count = 24— -^ 
EOR] 

EOF 


record 4 


20 


212 g 


7 


21 


EOI 


t t 












record length random addres* 

Oie record 3 pointer in the 
directory has been updated 



Figure 3-2. Modified Sample Random Access File Format 



The shaded areas in the figure represent records that are still present in the file, but are 
not referenced in the new directory. These areas will not be accessed by programs that 
access this file randomly using the new directory. 



RANDOM REQUEST PROCESSING 

The user program can request that the system perform the specified read or write request at 
the file position specified by the random request word (FET+6). If the file specified 
resides on mass storage and the random processing bit is set (r parameter in FET+1), then 
random access to the file can be performed. For a random write operation, the remainder of 
the file (the portion following the data written) is not released. On a sequential write 
operation, this portion of the file is released. 

The user program is responsible for managing the random addresses. For any CIO operation 
with r set in FET+1, the system returns the current random index (cri) in FET+6. The cri is 
the position of the file when the operation is completed. 
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Nonrandom write operations after an incomplete (no EOR or EOF written) random write 
operation are processed as random requests. Writing continues at the current position and 
the remainder of the file is not released. This feature makes the midrecord recalculation 

- .C *-!__ 1 -JJ —,. -,1 »~»J.- 1~ —J 4-,' J- 1 ... ^1 - .1 ^1"« • t 

uj. Lue itmuuiu duuicos umtcccoBai^ wucii ± aLunswd-y wnLiiig LccDmb icirger Luan Lrie o jlu circular 
buffer size. 

For a write operation with r set in FET+1 , if rr=0, a sequential write is performed at the 
current position. If rr^O, the action the system takes is as described for FET+6 fields 
earlier in this section. 

For a REWRITE operation with r set in FET+1, if rr=0, a random write is performed at the 
current position. If rrj^O, a random write is performed at rr. 

For the random file shown in figure 3-1, the following random requests (that is, r is set in 
FET+1) are necessary to perform the operations described. Figure 3-2 shows the modified 
random access file that results from performing these requests. 



Operation 


rr 


w 


cri 
Returned 


READ 


12 8 





13 8 


WRITER 


2000 8 





17 8 



Description 

Read directory. 

Write new record 3 at EOI; 
system sets location 2000g 
to 14g to indicate where the 
write occurred. 



WRITER 


7 


or 




RE WRITER 


1 


WRITEF 


17 8 


or 




REWRITEF 


17 8 



1 


12 8 





12 8 


1 


218 





21 8 



Write new record 4 in place. 
Word count = 212g. 

Rewrite directory. 



The user program must account for the extra sector written for EORs and EOFs when specifying 
rewrite-in-place operations. 

The system computes the number of sectors written as follows :t 







Word 




PRUs 


Data 


Remaining 


Operation 


Formula 


Count 


Example 
243/100 


Written 


in 


Buffer 


Buffer write 


n/100 


243 


2 




43 


EOR write 


(n+100) 
100 


243 


(243+100) 
100 


3 











300 


(300+100) 
100 


4 







EOF write 


(n+200) 
100 


243 


(243+200) 
100 


4 











300 


(300+200) 


5 








100 



Appendix H contains examples of COMPASS programs that create, read, and write a random file. 



i All numbers are in octal. 
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CIO PROCESSING ON SECURED SYSTEMS 

CIO performs the following additional processing on secured systems. 

READING FILES 

A read function (or an OPEN function that reads an index) performed on a file that has an 
access level higher than your job's current access level causes your job's access level to 
be raised to the access level of the file. 



WRITING FILES 

A write function (or a CLOSE function that writes an index) performed on a mass storage file 
with an access level lower than your job's current access level causes the file's access 
level to be raised to the access level of the job. Such a request on a tape file or an 
attached direct access file constitutes a security conflict and is rejected (unless you have 
special authorizations) since the access levels of these files cannot be changed while the 
files are attached to a job. 



CREATING FILES 

If CIO creates a local file as the result of a WRITE or OPEN request, the file is normally 
created with the same access level as the job's current access level. If the access level 
bit (bit 39) of FET+1 is set, however, the file is created with the access level specified 
in FET+4, provided that access level is valid for the job. Specifying an access level lower 
than the current access level of your job constitutes a security conflict, unless you have 
special permission. 



STATUS RETURNED BY OO 

If the access level bit (bit 39) in FET+1 is set, CIO returns the current access level of 
the file to the access level field In FET+4 after each CIO request. 



CIO OPEN AND CLOSE FUNCTIONS 

Two macros are available for opening files. 

• OPEN is applicable to all files. 

• POSMF is applicable only to labeled multifile tapes. 
Two macros are available for closing files. 

• CLOSE is applicable to all files. 

• CLOSER is applicable only to tape files. 
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POSMF is described in the discussion of file positioning functions. OPEN, CLOSE, and CLOSER 
are described in the following paragraphs. 

In general, there is no need to explicitly open or close mass storage files. The 
capabilities provided by open and and close functions for mass storage files can be obtained 
through the use of other system macros. For example, appendix H illustrates the random 
processing of a fil6 without using CIu open anu cxose functions. Also, the example in this 
section of data transfer macros shows how a sequential mass storage file can be read and 
written without using open and close functions. 



OPEN 

OPEN creates a file or determines certain information about a file for a job. If the file 
does not exist before the request to OPEN, it is created. 

On a secured system, performing an OPEN function on a file with an index has the same effect 
on the job access level as a READ; that is, if the access level of the file is higher than 
the current access level of the job, the job's access level is raised to the access level of 
the file. 

Macro format: 

Location Operation Variable 

OPEN addr.type.r 

addr Address of the FET for the OPEN request. 

type Type of function to be performed: 

Type Function (With Code in Octal) 

READNR Read, no rewind (100). 

READ Read and rewind (140). 

WRITENR Write, no rewind (104). 

WRITE Write and rewind (144). 

NR No rewind (120). 

ALTERNR Alter, no rewind (120). 

ALTER Alter and rewind (160). 

REELNR Read reel, no rewind (300). 

REEL Read reel and rewind (340). 

If the user program specifies a function type of REEL (or REELNR) and 
the file resides on mass storage, CIO assumes the type is READ (or 
READNR). If the type is not specified, ALTER is assumed. The functions 
listed do not change the system read/write lock on the file. 
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For mass storage files, all rewind functions are identical as are all 
no-rewind functions. That is, the only effect function type has on a 
mass storage file is to specify whether the file is to be rewound after 
it is opened (READ, WRITE, ALTER, or REEL), or whether it is to remain 
at its current position (READNR, WRITENR, NR, ALTERNR, or REELNR) . 

For magnetic tape files, READ, REEL, and ALTER perform identical 
functions and can be used interchangeably, as can READNR, REELNR, and 
ALTERNR. 

r Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 

The information supplied by OPEN includes: 

• The PRU size for the device to which the file is assigned (FET+4, bits 35 through 
18). The PRU size returned for a magnetic tape file depends on the tape data format 
(refer to appendix J). 

• The type of device on which the file resides (FET+1, bits 59 through 48). Refer to 
appendix E for a list of supported device types. In addition, bit 59 is set if the 
device is a nonallocatable nonmass storage device. 

The operations performed by OPEN depend on the type of device being used. 



Mass Storage Operations 

For mass storage files, if random processing is specified and proper pointers are set in 
FET+7, the last record of the file is loaded into the buffer specified. The random index on 
a file that is to be opened is expected to be the last record before the EOI. No EOFs may 
intervene. No indication of the length of the index loaded is returned other than a zero 
word in the buffer (OPEN clears the buffer before loading the index). If the buffer is too 
small to accommodate the entire index, an abnormal termination code of 23s is entered in 
FET+0, and the job step aborts unless the ep bit was set in FET+1. The random access bit 
(FET+1, bit 47) is cleared during an OPEN operation if: 

• The last record before the EOI is empty. 

• If the index length (FET+7, bits 18 through 35) is not zero and the index area FWA 
(FET+7, bits through 17) is less than two or greater than the job field length, 
the job step aborts. 

• The file does not reside on mass storage. 

For all OPEN functions on mass storage, the index for a file is loaded into the index area 
specified. 
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Example : 



The following example opens a random access mass storage file and reads the directory in 
nreoaration for random processing. 



BUFL EQU 2001 B 

INDXL EQU 100B 

FILE1 RFIL€B BUF,BUFL,(FET=8>,<IND=INDX,INDXL> 

BUF BSS BUFL 

INDX BSS INDXL 



OPEN FILE1,,R 



Unlabeled Tape Processing 

If a no rewind option is specified (code 100, 104, 120, or 300), the tape remains at its 
current position. If a rewind option is specified (code 140, 144, 160, or 340), the tape is 
rewound to the load point of the current volume. 



Nonstandard Labeled Taoe Processing 

Since the system cannot write nonstandard labels, the job step aborts if a WRITE (144) or 
WRITENR (104) function is specified for a file residing on a tape with nonstandard labels. 

If a no rewind option is specified (code 100, 120, or 300), the tape remains at its current 
position. If a rewind option is selected (code 140, 160, or 340), the tape is rewound to 
the load point of the current volume. 

Nonstandard labels are not read or returned to the CIO buffer. If the tape is at the load 
point, a subsequent read operation skips to the first tape mark before the read occurs. 



Standard ANSI Labeled Tape Processing 

When an ANSI labeled tape file is opened, the action the system takes depends on the xl bit 
(FET+1, bit 41). If xl is 0, standard label processing is performed; extended label 
processing is performed if xl is 1. 
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For standard label processing, all optional labels are ignored. If the FET for the file is 
at least 15g words long, FET+lls through FET+148 (refer to FET Description in section 2) 
contain the HDR1 data. The actual format of the HDR1 label is shown in appendix J. The 
HDR1 fields are described in detail in Volume 3, System Commands. All fields contain 
alphanumeric or numeric display code values. Alphanumeric fields are left-justified with 
blank fill. Numeric fields contain display code numeric digits and are right-justified with 
display code zero fill. 

The tape remains at its current position if a no rewind option is specified (code 100, 104, 
120, or 300). If a rewind option is selected (code 140, 144, 160, or 340), the tape is 
rewound to the load point of the current volume. 

The system reads and/or verifies the HDR1 label if the tape is at the load point and a READ, 
REEL, or ALTER option is selected (code 100, 120, 140, 160, 300, or 340), with the following 
restrictions or requirements. 

• If the FET length is less than 15g words, the system accepts a standard label 
without verification. 

• If the FET length is at least 15g words, the HDR1 data in FET+llg through FET+148 
is compared with that in the HDR1 label. Binary zero fields are not compared, 
although the actual value read is returned to the field. If any nonzero field does 
not match, the job step aborts. 

A nonzero retention cycle (FET+13g, bits 47 through 30) is used to calculate 
an expiration date that is compared with that HDR1 field on the tape. 

The HDR1 label is transferred to the CIO buffer (as space permits), although 
IN and OUT pointers are not updated to reflect the label information in the 
buffer . 

• All optional labels are ignored. 

The system writes a new HDR1 label if the tape at load point is opened for the first time 
with a WRITE operation specified (codes 104 or 144), and the FET length Is at least 15g 
words. Subsequent OPEN/WRITE operations (following an OPEN/READ or OPEN/WRITE) do not update 
the label information, even if the file is opened, closed, and then reopened. The following 
restrictions or requirements apply. 

• If the FET is less than 15g words in length, the previous HDR1 label information is 
not changed. 

• If the FET length is at least 15g words, the system uses the information in FET+llg 
through FET+14g for the HDR1 label. If any of the FET HDR1 fields are binary zero, 
the system uses the default value. The current date is used instead of the create 
date field in the FET. A nonzero retention cycle field is used to calculate the 
expiration date (default Is current date). 

• If a nonnumeric value is encountered in a numeric field, the job step aborts. 

• Previous HDR1 label expiration date is enforced; if the label date has not expired, 
the job step aborts. 
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Examole: 



The following example opens a magnetic tape file for standard label processing and 
veriij.es une cikri. laoei agaius l values preset Dy tne user program (.tne mi parameters 
are described in section 2). The magnetic tape file must have previously been assigned 
via a LABEL command or macro . 



BUFL 


EQU 


3001 B 


FET 


BSS 





TAPE1 


FILEB 


BUF,BUFL,LBL 




ORG 


FET+11B 


FET 11 


VFD 


60/10HACCOUNT FI 


FET12 


VFD 


42/0HLE,18/0H001 


FET13 


VFD 


12/0H01,18/0H003,30/0H79023 


FET1A 


VFD 


36/OHSETIDl,24/0HO001 




ORG 


* 


BUF 


BSS 


BUFL 




OPEN 


FET, REEL, R 



In the preceding example, FET+11 8 through FET+148 contain the HDR1 data. The tape is 
rewound to the load point of the current volume and the HDR1 data in the FET is compared 
with the HDR1 label on the tape. If any field does not match, the job step aborts; 
otherwise, the HDR1 label is transferred to the buffer BUF where the user can further 
process it (refer to appendix J for the format of the HDR1 label). 

If the OPEN macro in the preceding example is changed to 

OPEN FET,WRITE,R 

and the file is being opened for the first time, then the system uses the data in FET+llg 
through FET+14g to write a new HDR1 label on the tape. 



Extended Label Processing 

For extended label processing, a user label buffer, rather than the FET, is used to hold 
labels for processing. Extended label processing requires an FET length of at least 123 
words, and an extended label buffer. Extended label processing is disabled if these 
requirements are not met . 

The buffer location must be specified in FET+llg as follows: 



59 



FET + 11 



35 



17 



length of label buffer 



fwa of label buffer 



Within the buffer, each label must be preceded by a status word. 
59 11 



. . characters 
VX in label 
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Only bits 11 through should be set by the user program to show the number of characters In 
the label. This value must be 80 (120g), or the job step aborts. 

Remaining fields may be used by the label processor. The last label should be followed by a 
status word containing zeros in bits 11 through 0. Each label in the buffer appears, in 
display code, with the same format it has on the tape. 

The tape remains at its current position if a no rewind operation is specified (code 100, 
104, 120, or 300). If a rewind operation is selected (code 140, 144, 160, or 340), the tape 
is rewound to the load point of the current volume. 

If the tape is at the load point and READ, REEL, or ALTER Is selected (code 100, 120, 140, 
160, 300, or 340), the system reads all labels to the first tape mark and verifies the HDR1 
label, with the following exceptions. 

• If the label buffer does not contain an HDR1 label, the system accepts the standard 
label without verification. 

• If the label buffer contains an HDR1 label, any nonzero field in the label buffer is 
compared with that HDR1 field on the tape. If any nonzero field does not match, the 
job step aborts. 

• All labels from V0L1 through the first tape mark are transferred to the label buffer 
as space permits- Verification of additional labels is your responsibility * 

The system writes a new HDR1 label if the tape at load point is opened for the first time 
with a WRITE operation specified (code 104 or 144). If the file has been opened prior to 
the OPEN/WRITE, the label information is not updated even if the file is opened, closed, and 
reopened. Further requirements and restrictions are as follows: 

• V0L1 labels in the label buffer are ignored. 

• If an HDR1 label is not present in the label buffer, the system uses default values 
to create the HDR1 label for the tape. 

• If an HDR1 label is present in the label buffer, it is used to generate the HDR1 
label on the tape. If any field in the label buffer is binary zero, the default 
value for that field is used. The current date is used Instead of the create date 
in the buffer. The expiration date field is used; if zero, it defaults to the 
current date. 

• If a numeric field in the HDR1 label contains a nonnumeric value, the job step 
aborts. 

• Previous HDR1 label expiration date is enforced; if the label has not expired, the 
job step aborts. 

• All user labels to be written must be present in the label buffer. All user volume 
labels (UVL1 through UVL9), additional file header labels (HDR2 through HDR9), and 
user header labels (UHL) in the label buffer are written to the tape. Nonapplicable 
labels are ignored. 
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Example : 



The following example opens a magnetic tape file for extended label processing and 
verifies the HDR1 label on the tape against values preset by the user program in the 
label buffer (refer to appendix J for the format of the HDR1 label). 



BUFL 


EQU 


3001 B 


FET 


BSS 





TAPE1 


FILEB 


BUF,BUFL,LBL,XL 


BUF 


BSS 


BUFL 


LBUF 


VFD 


487,12/80 




VFD 


24/4HHDR1 ,36/6HACC0UN 




VFD 


6G/10HT FILE 




VFD 


6/lH,36/6HSETID1,18/3H000 




VFD 


6/1 H1 ,24/4H0001 / 24/4H0001 ,6/1 HO 




VFD 


6/1M,36/6H 79023,18/3H 79 




VFD 


18/3H023,6/1H ,36/0 




BSSZ 


3 


FET11B 


VFD 


24/,18/10D,18/LBUF 




SA1 


FET11B SET UP FE - 




BX6 


X1 




SA6 


FET+11B 




OPEN 


FET,READ,R 



If the OPEN macro in the preceding example is changed to 
OPEN FET,WRITE,R 

and the file is being opened for the first time, the system uses the data in the label 
buffer to generate the HDR1 label on the tape, provided all requirements and restrictions 
are met. 
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CLOSE 

CLOSE terminates operations on a file. 

Macro format: 



Location 

addr 
type 



Operation Variable 
CLOSE addr, type, r 



Address of the FET for the CLOSE request. 
Type of function to be performed: 



Type Function (with Code in Octal) 

NR File is not rewound (130). 

REWIND File is rewound (150). 

UNLOAD Tape file is rewound, released, and unloaded; mass 

storage file is released (170); It does not affect the 
user program's resource demand count (refer to UNLOAD 
macro). 

RETURN Tape file is rewound and released; mass storage file is 
released (174); the number of tapes or packs scheduled 
for the job may be decreased (refer to RETURN macro). 

If type is not specified, REWIND is assumed. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 

If the file resides on mass storage, the random processing bit is set, and the proper 
parameters are set in FET+7, CLOSE writes the data in the buffer specified in FET+7 at EOI 
of the file. This normally is the index for the file. A random index is written at the EOI 
only if the FET indicates that the file is random, the file's EOI position has changed since 
the last OPEN request, the file Is not locked, and an index area is specified in bits 17 
through of FET+7. 

On a secured system, performing a CLOSE function on a file with an index has the same effect 
on the file's access level as a WRITE; that is, if the access level of the file is lower 
than the current access level of the job, the file's access level is raised to the access 
level of the job. 
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Example : 



Random processing for the program shown in the first example of the OPEN macro can be 
terminated as follows: 



BUFL 

INDXL 

FILE1 

BUF 

INDX 



EQU 2001 B 

EQU 100B 

RF ILEB BUF,BUFL, ( FET=1 OB) , ( IND=INDX, INDXL) 

BSS BUFL 

BSS INDXL 



OPEN FILE1„R 



CLOSE FILE1„R 



In this example, the system writes the random index contained in the index buffer at the 
end of the file. 



NOTE 



CLOSE/UNLOAD and CLOSE/RETURN can no longer 
be used to queue files (these functions 
release the file from the job in the same 
manner as ONLOAD and RETURN, respect- 
ively). Programs using these functions 
should be rewritten to use the ROUTE macro 
if file queueing is desired. 



When a magnetic tape file is closed, the action the system takes depends on the last I/O 
operation performed. 

The system responds to a CLOSE request on a magnetic tape file in the following manner. 

1. If the last operation was a write, the system performs one of the following 
functions. 

• If the tape is unlabeled and the data format is S, L, or F, the system 
writes four tape marks. 

• If the tape is unlabeled and. the data format is I or SI, the system writes a 
tape mark, an EOF1 label, and three tape marks. 

• If the tape is labeled and standard label processing is in effect (xl, bit 
41 of FET+1, not set), the system writes a tape mark, an E0F1 label, and 
three tape marks. 
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» If the tape is labeled and extended label processing is in effect (xl, bit 
41 of FET+l, set), the system writes a tape mark, an E0F1 label, all user 
end-of-file labels (E0F2 through E0F9) and user trailer labels (UTL) present 
in the extended label buffer, and two tape marks. All nonapplicable labels, 
including E0F1 and E0V1 labels, in the extended label buffer are ignored. 
Refer to Extended Label Processing earlier in this section for a description 
of the label buffer. 

If the last operation was a read and the following are true, then all labels from 
this tape mark (beginning with E0F1) through the next tape mark are transferred to 
the extended label buffer, as space permits, beginning at the first word of the 
buffer. 

• "Hie tape is labeled. 

• Extended label processing is in effect (xl, bit 41 of FET+l, is set). 

• A tape mark immediately follows. 

2. If the no rewind (NR) option was selected, the tape remains positioned at or is 
repositioned to the same point as before the CLOSE was issued (to prevent the user 
program from going past EOI). 

li. tus rewinu ^ REWIND y option was selected, the system rewinds the tape to the 
beginning of data of the current file. This operation is performed automatically 
even if the current file begins on another reel. 

If the unload (UNLOAD) option was selected, the system rewinds and unloads the 
current tape reel, releasing job and file attachment. 



NOTE 



If PO=U processing option was specified at 
tape assignment time, the tape will not be 
physically unloaded from the tape drive. 



If the return (RETURN) option was selected, the system rewinds and unloads the 
current tape reel, releasing job and file attachment. The number of tapes scheduled 
for the job is decremented only if the total concurrent resource demand (tapes and 
packs) t has been satisfied. 



t Refer to the RESOURC command in Volume 3, System Commands. 
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CLOSER 

The CLOSER macro closes a magnetic tape reel. 

Macro format: 

Location Operation Variable 

CLOSER addr , type , r 

addr Address of the FET. 

type Type of operation to be performed: 

Type Function (with Code in Octal) 

NR No rewind (330). 

UNLOAD Unload (370). 

RETURN Return (374). 

omitted Rewind (350). 

If the specified file resides on mass storage, function 350 sets the 
file to BOI and function 370 releases the file. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 

When a read or write operation encounters end-of-reel, control is returned to the user 

program if the user processing (up) option is set in the FET. The tape is positioned so 

that if the user program attempts another I/O operation, the result is the same as for the 
previous read or write. 

The CLOSER macro enables the user program to initiate end-of-reel processing. The 
definition of end-of-reel varies according to the processing option the user selects (refer 
to End-of-Tape/End-of-Reel Conditions, appendix J). The action the system takes in response 
to a CLOSER request depends on the following two factors: 

• The last 1/0 operation performed. 

• The user processing option (FET+1, bit 45). 

The system performs the following sequence of actions during end-of-reel processing: 

1. If the last operation was a write, the system performs one of the following 
operations. 

• If the tape is labeled, unlabeled SI, or unlabeled I format, the system 
writes a tape mark followed by an E0VI label and three tape marks. If the 
user program has specified the VSN of the next reel (refer to Volume 3, 
System Commands, for a description of the VSN command), an E0V2 label 
containing that value is also written following the E0V1. User trailer 
labels present in the label buffer are written if extended label processing 
is in effect. Refer to Extended Label Processing earlier in this section 
for a description of the label buffer. 

• If the tape is unlabeled and the data format is S, L, or F (refer to 
appendix J), the system writes four tape marks. 
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If the last operation was a read, the system performs the following steps. 

a. If extended label processing is in effect, all labels following from E0V1 to the 
next tape mark are returned to the extended label buffer. 

b. If the tape has an E0V2 label (except for SI unlabeled tapes) and was written 
under NOS, the system extracts the VSN and proceeds to step 2. 

c. If the user has specified the VSN of the next reel, the system proceeds to step 
2. 

d. If the VSN of the next reel has not been specified and the tape has no E0V2 
label, the system proceeds to step 2. 

2. If the user processing option was selected, the system returns control to the user 
with end-of-reel status set in the FET. The user processing option does not apply 
to the RETURN (374) function. 

If the user processing option was not selected, the system returns control to the 
user program by setting the completion bit In the FET. In addition, if the tape is 
labeled and the FET length is at least 15 8 words, the system increments the file 
section number (FET+14 8 , bits 23 through 0). 

3. The system rewinds or unloads the tape as specified by the type parameter. The 
current reel is always unloaded if the next reel is not known or mounted. 

4. The system takes the following action if the file is continued on a subsequent reel. 

• If the VSN of the next reel is known and the reel is mounted, the I/O 
operation continues. If the VSN is not known or the reel is not mounted, 
the system requests the operator to mount it (the tape must be mounted on 
the same drive). Any labeled tape is accepted if the next VSN is not 
specified. 

• If the operation is a RETURN (374), a subsequent reel Is not requested. The 
file is returned after the EOV label sequence is written. 



CIO READ FUNCTIONS 

CIO processes the following read functions. 



NOTE 



On a secured system, performing a read 
function on a file that has a higher access 
level than your job's current access level 
causes your job's access level to be raised 
to the access level of the file. 
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RPHR (000) 

RPHR causes one PRU to be transferred into the circular buffer. 
The status responses (bits 17 through of FET+0) are: 

00000 1^ Full sector. 

00002lt EOS. encountered. 

7 4003 it EOF encountered. 

741031^ EOI encountered. 

Macro format: 



Location 



Operation Variable 



RPHR 



addr,r 



addr 



Address of the FET. 

Auto recall option; if r is specified, control is not returned to the 
user program until the operation is complete. 



READ (010) 

The READ function reads information into the circular buffer. If there is room in the 
buffer for at least one full physical record, the system initiates reading and continues 
until: 

• The available circular buffer space will not accommodate one full PRU. 

• An end-of-record or end-of-file is encountered. 

• The end-of-information is encountered. 

• For S and L format tapes, one PRU is read. 
The status responses (bits 17 through of FET+0) are: 

00001 it Buffer filled. 

00002 it E0R encountered. 

74003 it EOF encountered. 

74103 it EOI encountered. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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Data is not transferred after an EOR or EOF mark is encountered. For tapes that do not have 
a defined EOI (refer to appendix J), an operation that normally would terminate at EOI 
terminates instead at EOF. Also, for S and L format tapes, the unused bit count is returned 
to FET+6, bits 29 through 24, when the read is complete. 

Macro format : 

Location Operation Variable 
READ addr.r 

addr Address of the FET. 

r Auto recall option; if any value is specified by r, control is not 

returned to the user program until the operation is complete. 



READSKP (020) 

READSKP performs a read function until the buffer is filled or until an EOR or EOF is 
encountered. If the buffer is filled before an EOR is encountered, CIO positions the file 
at the next EOR, EOF, or EOI, whichever is encountered first. 

The status responses (bits 17 through of FET+0) are: 

000021* Buffer filled or EOR encountered (file is positioned at beginning of 
next record). 

740031* EOF encountered. 

74103 it EOI encountered. 

For tapes that do not have a defined EOI (refer to appendix J) , an operation that normally 
terminates at EOI terminates instead at EOF. 

This is the only read function that performs the read operation if less than one PRU of 
space is available in the buffer. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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Macro i.Ci.ui3ut 

Location Operation Variable 

READSKP addr , level , r 

addr Address of the FET. 

level Level number (0 through 17g) specified in FET+0, bits 17 through 14; 
if a level number is specified, information is skipped until the 
occurrence of an EOR with a level number greater than or equal to the 
one specified: 

0-16 8 After the buffer is full, skip to the next EOR. 
178 After the buffer is full or a full record is placed in 
the buffer, skip to the next EOF. 

For S and L format tapes, only a request with level 17g is 
recognized; any other level in the request is ignored. 

r Auto recall option; if any value is specified by r, control is not 

returned to the user program until the operation is complete. 

For S and L format tapes, the user program should set the mlrs field (FET+6, bits 17 through 
0) before issuing the READSKP function. If mlrs is 0, the system assumes 512 words for an S 
tape and 377777g for an L tape. Thus, if a READSKP is issued on an L tape and mlrs is 0, 
a block too large error occurs if a block is encountered that is larger than 377777g qi 
words. 



READCW (200) 

Macro format: 

Location Operation Variable 

READCW addr, level, r 

addr Address of the FET. 

level Termination level: 

0-16g Continue reading over EOFs (stops at E0I or buffer 
full). EOFs are returned in data as zero length 
blocks with level 17g. 
17g Stop reading at next EOF. EOF status is returned to 
the FET, but no EOF data block (zero length and level 
17g) is returned to the CIO buffer. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 
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The READCW function performs a nonstop read of PRUs bounded by control words. The PRU 
format is: • 



59 54 47 



35 



29 



mzr* 



23 



p|7/%c PRU size 



be 



block length 



doto word 



data word 



data word 



Itvel 



p Parity error indication (is set for each block in error when reading 

with the ep bit set in the FET) . 

c Bit 54 is set if coded operation (tape operations only). 

PRU size Number of CM words in each PRU on the device Prefer to a^^endis J for 

a description of PRU sizes). 

ubc Unused bit count (0<ubc<ll). Ignored for mass storage files. For I 

and SI format tapes, ubc must be 0. For F, S, and L format tape read 
and write operations, ubc is processed as accurately as possible 
within the constraints of the hardware. 

block length Count of the number of 12-bit data bytes in the PRU. For mass storage 
files and I and SI format tapes , it must be equal to five times the 
number of CM words occupied by the data. 



level 



Logical record level number: 



0-16 8 
17 8 



The PRU is an EOR. 
The PRU is an EOF. 



This function allows the user program to read nonstop and detect EORs and EOFs without 
having to recall CIO for the next sequential read. Reading terminates normally if the 
buffer becomes full or if the EOI is detected. If the request is made with the level number 
equal to 17g (that is, FET+0, bits 17 through 14), reading stops at the next EOF. 

This function may only be used with mass storage and magnetic tape devices. 
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READLS (210) 

The READLS function reads the group of mass storage logical records specified in a list 
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lower 18 bits of FET+5. READLS continues reading until the list is exhausted or the buffer 
is filled. 



Macro format: 



Location 



Operation 
READLS 



Variable 



addr.r 



addr 



Address of the FET. 

Auto recall option; if any value is specified by r, control is not 
returned to the user program until the operation is complete. 



FET+5 contains the address of the list in the following format. 



FET+5 



fcm^m^^^M 



la 



r Set by CIO if this is not the initial READLS call, 

la Address of the list. 
The list is in the following format. 

59 17 




rsa^ 



Random sector address. 
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The status responses (bits 17 through of FET+0) are: 

74003 it Operation complete. Entire list read. The value of la in FET+5 is set 
to terminator word. 

00021 it Operation not complete, la in FET+5 contains the address of the next 
entry of the list to be processed. If the buffer is full, r is set to 
1. If the buffer is not full, CIO has reached an internal limit and has 
stopped processing the list. After emptying the buffer, the user 
program should call CIO again to continue processing the list. 

RPHRLS (230) 

The RPHRLS function reads the group of mass storage PRUs specified by a list supplied by the 
user program. This function performs the same operation as READLS except that each address 
in the list specifies a single PRU instead of a record. After the single PRU specified by 
each list entry is placed in the buffer, the list position is advanced. 

Macro format: 



Location Operation Variable 
RPHRLS addr.r 

addr Address of the FET. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refei to the description of the code field of FET-t-0 at the 
beginning of this section.) 
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REAONS (250) 

The READNS function reads a file from the current position to an EOF. 
The status responses (bits 17 through of FET+0) are: 

00025lt Buffer full. 

74003lt EOF encountered. 

741031t EOI encountered. 

Macro format: 

Location Operation Variable 
READNS addr.r 



addr 



Address of the FET. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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READN (260) 

The READN function reads data from an S or L format tape into the circular buffer. Reading 
continues until one of the following occurs: 

• The buffer is full. 

• An EOF is encountered. 

• The EOI is encountered. 

Status responses (bits 17 through of FET+0) are: 
00026lt Buffer full. 
740271 t EOF encountered. 
741271 t EOI encountered. 

Macro format: 



Location 



Operation 



READN 



Variable 



addr,r 



addr 



Address of the FET. 



r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 

Before this function is issued, the mlrs field in FET+6, bits 17 through must be set to 
the largest physical record that will be encountered. For S format, if mlrs is 0, the value 
of the maximum block is assumed to be 512 words. For L format, if mlrs is 0, the assumed 
maximum block is (LIMIT-FIRST-2). In addition, the file mode bit (FET+0, bit 1) must be set. 

Each physical record in the circular buffer is preceded by a header word. This word is 
generated by the system; it does not exist on the tape. The format of the header word is: 



59 



29 



23 



17 



y///////////////////////M 


ubc 


W/, 


block size 



ubc 



Unused bit count. Number of bits in the last word that are not valid 
data; ubc may range from to 55. 



block size Number of CM words in the physical record. 

After each complete physical record has been placed in the buffer, the system moves the IN 
pointer to reflect both the header and the data. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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READEI (600) 

The READEI function reads information into the circular buffer. Reading continues until an 

WAT 1. i ~ 

FET+0) are: 

000601 t Buffer full. 
741031 t E0I encountered. 



Macro format: 



Location 



Operation 
READEI 



Variable 



addr , r 



addr 



Address of the FET. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



CIO WRITE FUNCTIONS 

CIO processes the following write functions. 



NOTE 



On a secured system, performing a write 
function on a mass storage file with an 
access level lower than your job's current 
access level causes the file's access level 
to be raised to the level of the job. Such 
a request to a tape or an attached direct 
access file is rejected as a security 
conflict (unless you have special 
authorizations), since the access levels of 
these files cannot be changed while the 
files are attached to a job. 



fThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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WPHR (004) 

WPHR writes one physical record from the circular buffer, 
one full PRU, no operation occurs. 



If the buffer contains less than 



Macro format: 

Location Operation Variable 
WPHR addr.r 



addr 

r 



Address of the FET. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



WRITE (014) 

WRITE transfers the contents of the circular buffer to the specified file. Writing 
continues until the buffer contains less than one full PRU of data (a WRITER request empties 
the buffer and writes an end-of-record on the file). 



Macro format: 




Location 


Operation Variable 




WRITE addr,r 


addr 


Address of the FET. 


r 


Auto recall option: 



other 



The * option sets the WRITE function code (CIO function 
code 014 8 ) in FET+0 and returns to the calling 
program. The WRITE function is not performed at this 
time. 

For further information concerning use of the * option, 
refer to WRITECW (204) later in this section. 

Control is not returned to the user program until the 
operation is complete. 



For S and L format tapes, only one record is written for each request. The length of the 
record is determined by the value of the IN and OUT pointers. 
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WR5TER {024} 

WRITER writes the entire contents of the buffer to the file specified.t The last PRU is 
written as a short PRU (refer to appendix J). If the data exactly fills the last PRU, the 
system adds a PRU with no data to Indicate the end of the record. A WRITER request with 
level 17s set in FET+0, bits 17 through 14, performs the same operation as a WRITEF 
request. 

Macro format: 

Location Operation Variable 
WRITER addr.r 

addr Address of the FET, 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 



WRITEF (034) 

WRITEF writes the entire contents of the buffer to the specified file. The last PRU 
written is the end-of-file. If there is data in the buffer, the system writes the data 
followed by an EOR and an EOF. If the buffer is empty and the last operation was an 
incomplete write (last PRU written was not EOR or EOF), an EOR and an EOF are written; 
otherwise only an EOF is written. For S and L format tapes, data in the buffer is 
transferred to tape and followed by a tape mark. 

Macro format: 

Location Operation Variable 
WRITEF addr.r 

addr Address of the FET. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 



tThe OUT pointer is updated. The IN pointer is not changed. 
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WRITECW (204) 

The WRITECW function performs a nonstop write of PRUs bounded by control words. The PRUs 
are in the same format as specified for READCW. A level number of 17g on a PRU that 
contains data is ignored. Data written using this function is stored on the device in the 
same format as if it had been written with any other write function (that is, the control 
words are not part of the data). 

WRITECW may only be used with mass storage and magnetic tape devices. 



NOTE 



The WRITECW function cannot be used to 
perform a write on a file attached in U 
(update) mode. 



Macro format: 

Location Operation Variable 
WRITECW addr.r 

addr Address of the FET. 
r Auto recall option: 



The * option sets the WRITECW function code (CIO 
function code 204g) in FET+0 and returns to the 
calling program. The WRITECW function is not performed 
at this time. 

If the symbol WRIF$ is defined in assembly and a data 
transfer common deck attempts to issue a write request 
(refer to Data Transfer Macros in this section), it 
will use the CIO request set in the FET instead of a 
WRITE (014g) request. The data transfer common 
decks, by default, issue a WRITE (014g request if 
WRIF$ is not defined). The WRITE macro can be used to 
reset the FET after using the * option with a WRITECW, 
WRITEN, or REWRITE macro. 

If used, this option should be issued before any 
writing is performed on the file. 
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! NOTE ! 

i i 

The appropriate data transfer common 

ud.n. uiuoi. uc aaaciuuicu WX UI1J-LI L. LlC use 

program (that is, the SYSLIB version 
cannot be used) or the WRIF$ is 
meaningless . 



For example , the following sequence ensures that the data 
transfer common deck GOMCWTW issues a WRITECW request 
instead of a WRITE request if it is required to write the 
circular buffer. 



IDENT WRT 



WRIFS EQU 

OPL XTEXT COMCWTW 



WRITECW F,* 



WRITEW F,WBUF,100B 



F FILEB FBUF,2001B,FET=13 

FBUF BSS 2001B 

WBUF BSS 100B 



END WRT 

other Control is not returned to the user program until the 
operation is complete. 
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REWRITE (214) 

REWRITE performs the same operation as the WRITE function with the exception that it causes 
the system to process the operation as a random function; that is, the remainder of the file 
following the portion written is not destroyed. If the random parameters (r, rr, and w) are 
not specified in the FET, the write operation takes place at the current position. If the 
random parameters rr and w are specified, the normal random addressing procedures are 
followed. The file to be rewritten must reside on mass storage. A subsequent CLOSE 
function will not cause an update of the random index for the file, unless another CIO write 
function has altered the position of EOI since the last OPEN function. 



NOTE 



REWRITE does not ensure that the new record 
being rewritten is not longer than the 
original record. 



Macro format: 

Location ' Operation Variable 
REWRITE addr , r 

addr Address of the FET. 
r Auto recall option: 



* The * option sets the REWRITE function code (CIO 
function code 214s) in FET+0 and returns to the 
calling program. No actual REWRITE function Is 
performed at this time. 

For further information concerning use of the * option, 
refer to the WRITECW macro. 

other Control is not returned to the user program until the 
operation is complete. 
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REWRITES* (224) 

REWRITER performs the same task as WRITER with the exceptions noted for REWRITE. The file 
must reside on mass sec 
operation as REWRITEF. 



must reside on mass storage, ii tue ievex iiuwuei is 17g, KiswKi.'1'iSK. periorms the same 



Macro format: 



Location Operation Variable 



REWRITER addr.r 



addr Address of the FET. 



Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



NOTE 



The last PRU is written as a short PRU 
(refer to appendix J). If the data exactly 
fills the last PRU, the system adds a PRU 
with no data to indicate the end of the 
record. 



REWRITEF (234) 

REWRITEF performs the same task as WRITEF with the exceptions noted for REWRITE. The file 
specified must reside on mass storage. A subsequent CLOSE function will not cause an update 
of the random index for the file, unless another CIO write function has altered the position 
of EOI since the last OPEN function. 

Macro format: 

Location Operation Variable 
REWRITEF addr,r 

addr Address of the FET. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 



NOTE 



An extra PRU is written to specify an EOF. 
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OVWRITE (244, 254) 

The OVWRITE macro destroys the existing contents of a mass storage file by writing a 
specified binary pattern of information to the file. The entire file from BOI to EOI is 
rewritten. 

This macro overwrites local files and attached direct access permanent files. In order to 
overwrite an indirect access permanent file, execute an OVWRITE macro on a local copy of the 
file followed by a REPLACE macro. 



Macro format: 



Location 

addr 
pat 



Operation 
OVWRITE 



Variable 



RETURN 



addr, pat, RETURN, r 

Address of the FET. 

The pattern of information to be written to the file. If pat is X, the 
file is first overwritten with binary zeros, then with binary ones, 
then with an alternating pattern of binary ones and zeros. If pat is 
omitted or if any value other than X is specified, the file is 
overwritten with binary zeros. 

If RETURN is specified, CIO function 254 is issued and the file is 
returned after processing. If RETURN is not specified, CIO function 
244 is issued and the file is not returned. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 
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WRITEN (264) 



The WRITEN macro writes nonstop on an S or L formatted magnetic tape. S and L formatted 
tanes are described in annei 
end— of-reel is encountered. 
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Location 



Operation 
WRITEN 



Variable 



addr,r 



addr 



Address of the FET. 
Auto recall option: 



other 



The * option sets the WRITEN function code (CIO function 
code 2648) in FET+O and returns to the calling 
program. The WRITEN function is not performed at this 
time. 

For further information concerning use of the * option, 
refer to the WRITECW macro. 

Control is not returned to the user program until the 
operation is complete. 



The user program must provide a header word immediately preceding each record in the 
buffer. This header is not physically written on the tape. Its format is: 



59 29 23 17 



block size 



ubc 



Unused bit count. Number of bits that are not valid data in the 
last word; ubc may range from to 55. 



block size Number of CM words in the physical record. 

The system compares the mlrs and ubc fields in FET+6 using information from this header. 

The OUT pointer is not changed to reflect the move until after each complete record has been 
written to tape. 
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FILE POSITIONING FUNCTIONS 

The following functions control the positioning of a file. If the FET indicates that the 
file is being accessed randomly, the random address of the new position (cri) is always 
returned. 

Status responses assume coded mode (bit 1 of FET+0 clear). If binary mode is specified (bit 
1 of FET+O set), the responses end in 3 instead of 1. For example, 041 for coded mode is 
043 for binary mode. 

BKSP (040) 

BKSP causes a file to be backspaced one logical record. If the BOI of the file (or the load 
point of the current volume in a multivolume tape file) is encountered before backspacing is 
complete, even if the file was originally at BOI, a rewind status is returned (05x). If the 
backspace causes the file to be positioned after BOI or exactly at BOI, a backspace status 
is returned (041). 

If the operation terminates on an EOF, 17 8 is returned to the FET level number (In) field 
(FET+O, bits 17 through 14). 



Location Operation Variable 



BKSP addr.r 



addr Address of the FET. 



Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 
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BKSPRU (044) 

BKSPRU causes the file to be backspaced the specified number of physical records. If the 
BOI of the file (or the load point of the current volume in a multivolume ta~e file" 1 is 
encountered before backspacing is complete, even if the file was originally at BOI^a^rewind 
status is returned (05x). If the operation causes the file to be positioned after'BOI or 
exactly at BOI, the backspace status is returned (045). The skip count is set in the RA+1 

For tape files, if the operation terminates on an EOF, 17 8 is returned to the FET level 
number (In) field (FET+0, bits 17 through 14). 

Macro format: 



Location 



Operation 



BKSPRU 



Variable 



addr,n,r 



addr 



Address of the FET. 

Number of PRUs to backspace. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



REWIND (050) 

REWIND causes a mass storage file to be positioned at BOI. 

For tape files that are multifile sets, the file is positioned to the beginning of the 
current file. If the tape Is unlabeled, or if there is only one label at the beginning of 
the tape, a REWIND positions to the beginning of the first file on the tape. 

If the file specified in the FET is not local to the job, no operation is performed. 

In all cases, REWIND resets the IN and OUT pointers in the FET to the value of FIRST. 

Macro format: 



Location 



Operation 



REWIND 



Variable 



addr,r 



addr Address of the FET. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 

For a mass storage file, if the random processing bit is set in the FET, the current random 
index (crl) is returned as the beginning of the file (random address 1). 
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If the file resides on magnetic tape, the action the system takes depends on the last I/O 
operation performed. 

The system responds to a REWIND request as follows: 

1. If the last operation was a write, one of the following operations is performed. 

• If the tape is labeled, the system writes a tape mark, an E0F1 label, and 
three tape marks. 

• If the tape is unlabeled and the data format (refer to appendix J) is S, L, 
or F, the system writes four tape marks. 

• If the tape is unlabeled and the data format is I or SI, the system writes a 
tape mark, an E0F1 label, and three tape marks. 

If the last operation was a read, the system proceeds to step 2. 

2. The system rewinds the tape to the beginning of data of the current file. This 
operation is performed automatically even if the current file begins on another reel. 



UNLOAD (060) 

UNLOAD causes the specified file to be rewound and unloaded. If the file resides on mass 

storage, UNLOAD performs the same function as RETURN. For tape files and files residing on 

removable packs, the UNLOAD function does not decrease the number of tape, or pack resources 
scheduled for the job via the RESOURC command. 

Macro format: 

Location Operation Variable 



UNLOAD addr.r 



addr Address of the FET. 



r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 

If the file resides on magnetic tape, the action the system takes depends on the last I/O 
operation performed. 
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The system responds to an UNLOAD request as follows: 

1. If the last operation was a write, one of the following operations is performed. 

• If the tape is labeled, the system writes a tape mark, an E0F1 label, and 
three tape marks. 



ir trie tape is unlabels 
writes four tape marks. 



d ana the data format is 8, L, or F, the system 



• If the tape is unlabeled and the data format is I or SI, the system writes a 
tape mark, an E0F1 label, and three tape marks. 

If the last operation was a read, the system proceeds to step 2. 

2. The system rewinds and unloads the tape. 



RETURN (070) 

RETURN causes the specified file to be released from control of the job. The operation 
performed depends on the type of file. 

Type Operation 

Input The file name is changed to INPUT*; file space is not released and 

file INPUT* remains attached to the job as a local file. 

Library Job attachment is released but file space remains. 

Permanent File interlock (read/write) is cleared} job attachment is released; 

file space remains (if the file has been purged, the file space may be 
released at this time). 

All others File space and job attachment are released. 

If the file resides on magnetic tape, the RETURN macro performs the same function as the 
UNLOAD macro. In addition, the RETURN of a magnetic tape file or your last direct access 
file for a particular removable disk pack decrements the resource demand count (as scheduled 
by the RESOTJRC command) only if the total concurrent resource demand (tapes and disk packs) 
has been satisfied. If the file is a deferred routed file (refer to section 7), the file 
space and job attachment are released. 



Macro format: 



Location 



Operation 



RETURN 



Variable 



addr,r 



addr 
r 



Address of the FET. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 
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POSMF (110) 



The POSMF macro opens and/or positions standard ANSI-labeled multifile magnetic tape sets to 
a member of the set. The file to be opened is determined by the contents of the label 
fields of the FET or, if the xl bit is set, the contents of the HDR1 label in the extended 
label buffer. The relative position of the file within the multifile set is specified by 
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the file sequence number field. 

Macro format: 

Location Operation Variable 
POSMF addr.r 

addr Address of the FET. 



Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



Standard ANSI Labeled Multifile Set Processing 

The PRU size (FET+4, bits 35 through 18) and device type (FET+1, bits 59 through 48) are 
returned to the FET as described in appendix J. The FET length must be at least 15s words. 

A multifile set is positioned to read an existing file if the file sequence number in the 
FET is not display code 999. The following restrictions and requirements also apply. 



• 



The tape is positioned to the first member of the multifile set whose HDR1 fields 
match the HDR1 data in FET+11 8 through FET+14 8 . Binary zero fields are not 
compared. A nonzero retention cycle is used to calculate an expiration date that is 
compared with that on the tape. If all fields do not match, the search continues. 

• If the explicit or implicit position number is greater than that of the last member 
file (that is, the matching HDR1 was not found), POSMF is terminated, returning an 
end-of-set status (21 8 set in bits 13 through 9 of FET+0) and updating the file 
sequence number field in the FET to one greater than that of the last member file. 
The HDR1 for the last member file is transferred to the CIO buffer, although IN and 
OUT are not updated. The current job step aborts. 



• 



If the desired file is located, the HDR1 label is transferred to the CIO buffer, as 
space permits, although the IN and OUT pointers are not updated to reflect the label 
information in the buffer. Actual values read are returned to the label FET fields. 

All optional labels are ignored. 
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A multifile set is positioned to write a new file if the file sequence number in the FET is 
display code 999. Further requirements are as follows: 

• The first file of a multifile set is created if all of the following are true (refer 
to examples 1 and 2): 

The tape is positioned to the first file. 

The last operation was not a write. 

The set ID field in the initial HDR1 label on the tape is all blanks (the 
set ID field in the FET must be nonblank if the set is to be extended in the 
future). 

• The multifile set is positioned to extend the set in all other cases. The tape is 
positioned to after the last file in the multifile set. 

• The system writes a new HDR1 label to the tape with the following results. 

The file sequence number of the new HDR1 label is set to display code 0001 
for the first file, or is set to the last member sequence number plus 1 for 
extended files. 

The section number in the HDR1 label is always set to display code 0001. 

The set ID is always set to the set ID of the previous member. This ensures 
that the set ID is unique within a multifile set. 

With the above exceptions, the information -in FET+llg through FET+14g is 
used to create the HDR1 label. The default value is used for any FET HDR1 
field that is binary zero. If a numeric field contains a nonnumeric value, 
the job step aborts. 

The creation date field in the FET is ignored; the current date is always 
used. 



Extended Label Multifile Set Processing 

If the FET length is less than 12g words, the job step aborts. 

The PRU size (FET+4, bits 35 through 18) and device type (FET+1, bits 59 through 48) are 
returned to the FET as described in appendix J. 

To avoid a fatal error, an HDR1 label must be present in the extended label buffer (refer to 
extended label processing under the OPEN macro for a description of the extended label 
buffer) . 
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A multifile set is positioned to read an existing file if the file sequence number in the 
buffer HDR1 label is not display code 9999. The following requirements also apply. 

• The tape is positibned to the first member of the multifile set whose HDR1 label 
matches that in the label buffer. Binary zero fields are not compared. If the 
fields do not match, the search continues. 

• If the explicit or implicit position number is greater than that of the last member 
file (that is, the matching HDR1 was not found), POSMF is terminated, returning an 
end-of-information status (21 g in FET+O, bits 13 through 9). 

• If the desired file is located, all labels from HDR1 through the next tape mark are 
transferred to the label buffer, as space permits. The user program is responsible 
for verification of additional labels. 

A multifile set is positioned to write a new file if the file sequence number in the buffer 
HDR1 label is display code 9999. Further requirements or restrictions are as follows: 

• The first file of a multifile set is created if all of the following are true (refer 
to examples 1 and 2). 

The tape is positioned to the first file. 

- The last operation was not a write. 

The set ID field in the existing HDR1 label on the tape is all blanks (the 
set ID field in the buffer HDR1 label must be nonblank if the set is to be 
extended in the future). 

• The multifile set is positioned to extend the set in all other cases. The tape is 
positioned after the last file in the multifile set. 

• The system writes a new HDR1 label and all additional user labels to the tape with 
the following results. 

The file sequence number in the HDR1 label of the new file is set to display 
code 0001 for the first file or set to the last member sequence number plus 
1 for extended files. 

The file section number in the HDR1 label is always set to display code 0001. 

The set ID is always set to the set ID of the previous member. This ensures 
that the set ID is unique within a multifile set. 

With the above exceptions, the information in the extended label buffer is 
used to generate the HDR1 label on the tape. The default value is used for 
any buffer HDR1 field that is binary zero. If a numeric field contains a 
nonnumeric value, the job step aborts. 

The creation date field in the buffer HDR1 label is ignored; the current 
date is always used. 

All additional user file header labels (HDR2 through HDR9) and user header 
labels (DHL) in the label buffer are written to the tape. Nonapplicable 
labels are ignored. 



3-48 



60459690 A 



Example 1 : 



1. BLANK, VSN=TEST,D=HY,MT. 



2. LABEL,TAPE,VSN=TEST,LB=KL,F=S,MT. 

Causes tape to be assigned and positioned at file 1 • 

3. LGO. 

Executes program where POSMF on file TAPE with recall specified is performed with 
sequence number set to 999 (or 9999) and a nonblank SETID set in the FET (or xl 
buffer). This causes the first file of the multifile set to be created using the 
label fields specified in the FET (or xl buffer). 

Subsequent POSMFs with sequence number set to 999 (or 9999) cause the file to be 
extended since the SET ID field on the tape is not nonblank. 



Example 2: 

Repeat the preceding example except that a 

LABEL, TAPE, VSN=TEST,SI«TESTAA,F=S,MT,W. 

is performed at step 2. The POSMF in the third step extends the file set since the 
SETID is nonblank on the tape. 

Example 3: 

This example deals with a multifile set contained in two volumes with the following 
structure (the structure of multifile labels is outlined in Volume 3, System Commands). 



Volume I 



Volume H 



A 
i 



D 



VOL1 HDR1 


* 


file 1 
data 


* 


EOF1 


* 


HDR1 


* 


file 2 
data 


* 


EOV1 






E 
* 


F 






G 
* 


H 
if 


: 


: 


V0L1 HDR1 


* 


file 2 
data 
(cont) 


* 


E0F1 


* 


HDR1 


* 


file 3 
data 


* 


E0F1 


* 


« 
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The following steps create a multifile set with this structure. 

1. OPEN or LABEL With section number=l, sequence number not specified 

(default is 1). 

2. Write data (File set 1). 

3. POSMF With sequence number set to 999. 

4. Write data (Goes over end of reel) (file set 2). 

5. POSMF With sequence number set to 999. 

6. Write data (File set 3). 

7. REWIND This causes the trailer label at H to be written. The 

tape is then rewound to the beginning of Volume II 
(position E) and then the file is positioned forward to 
G. The tape is not necessarily at load point following 
a rewind of a multifile set member, rather at the start 
of the multifile set member. The only means, at this 
point, to position to the beginning of Volume I is to 
issue a POSMF with sequence number 1. 

If the multifile is positioned at the end of file set member 2 (F), a rewind 
positions the tape to the beginning of Volume I since file set member 2 begins 
on Volume I, and then positions Volume I to D. 

By writing over file set member 2, file set member 3 is destroyed. 

A POSMF 999 followed by a WRITE creates a file set member at I. 

To copy all three file set members, the following technique may be used. 

1. OPEN with display code 001 (or 0001) sequence number and all other label 
fields binary zero. 

2. READ to E0I. (C) 

3. POSMF with display code 002 (or 0002) sequence number and all other 
label fields binary zero. This positions to next file set member at (D). 

4. READ to EOI. (F) 

5. POSMF with display code 003 (or 0003) sequence number and all other 
label fields binary zero. 

6. READ to EOI. (H) 
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The SI (M) parameter must be present in order to position multifile labels using commands. 
If the QN (P) parameter is present, the multifile set is positioned to the file set member 
that matches the specified sequence number. If QN is not specified and the FI (L) parameter 
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identifier specified. If both QN and FI are specified, a match must occur on both sequence 
number and file identifier. If neither QN nor FI is specified, an OPEN is done instead of a 
POSMF. 

To extend a multifile set, QN must be set to 9999 .t 

Setting the QN parameter to zero advances the pointer to the next multifile. This is not 
true of a LABEL command. 

If the SI parameter is not specified, then file positioning is not done. The R and W 
parameters on the LABEL command are ignored if SI is specified. The exception Is if the W 
parameter is specified and QN<1, and it is the first OPEN on the file, then an OPEN/WRITE is 
performed. 

Although the sequence number field in the HDR1 label is four characters in length, only the 
rightmost three characters are used to differentiate between 999 and another valid sequence 
number. This occurs because on an open (POSMF), the FET field for sequence is only three 
characters. Therefore, if extended labels are not being used, a limit of 998 file set 
members per file set is enforced. 



EVICT (114) 

The EVICT macro is similar to the RETURN macro in that it releases file space for the 
specified file. It differs from RETURN in that EVICT does not release the file attachment 
to the job. When an EVICT is performed on a deferred routed queue file (refer to ROUTE 
macro, section 7), all file routing information associated with the file is cleared. 

Macro format: 

Location Operation Variable 
EVICT addr.r 

addr Address of the FET. 

r Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 

The operation that EVICT performs depends on the file type. For the primary file and 
permanent files, all file space except the first track is released, job attachment remains, 
and an EOI is written on the first sector of the first track. For all other mass storage 
file types, file space is released and job attachment remains. Files for which write 
lockout is set are returned to the system. An EVICT of a tape file performs the same 
functions as the UNLOAD macro. 



tWhen a multifile set is extended, the set ID of the new file is always set to the same 
value as the previous file. This ensures that the set IDs of all set members are the same. 
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SKIPF (240) 

SKIPF causes the file to be positioned n records forward from the current position. The 
operation terminates when the skip count is satisfied or when EOI is encountered on a mass 
storage file or a tape file. 

The status responses (bits 17 through of FET+0) are: 

026lt Last record skipped was EOR. 

74027 if Last record skipped was EOF. 

74127lt EOI encountered. 
Macro format : 



Location 



Operation 



SKIPF 



Variable 



addr,n,r 



addr Address of the FET. 

n Number of records to skip; if n is omitted, 1 is assumed. 

r Auto recall option; if r is specified, control is not returned to the 

user program until the operation is complete. 

SKIPFF (240) 

SKIPFF skips forward the specified number of files. 

The status responses (bits 17 through of FET+0) are: 

74027 it Last record skipped was EOF. 

741 27 it EOI encountered. 
Macro format: 



Location 



Operation 



SKIPFF 



Variable 



addr,n,r 



addr 



Address of FET. 

Number of files to skip; if a is omitted, 1 is assumed. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation Is complete. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section). 
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SKIPEI (240) 

SKIPEI causes the file to be positioned at EOI. The skip count in RA+1 is set to 777777s 
to indicate a skip to EOI. The status returned in bits 17 through of FET40 is 741271. On 
tape files where no EOI is defined, the skip operation stops at an EOF. 

Macro format: 



Location 



Operation 



Variable 



SKIPEI 



addr,r 



addr Address of the FET. 

r Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



SKIPB (640) 

SKIPB causes the file to be backspaced n logical records. If the BOI of the file (or the 
load point of the current volume in a multivolume tape file) is encountered before 
backspacing is complete, even if the file was originally at BOI, a rewind status (05k) is 
returned. If the file is positioned after BOI or exactly at BOI, backspace status is 
returned (641t). If the skip stops at an EOF, the level number is set to 17g (status 
returned is 7406411"). 

Macro format: 



Location 



Operation 



Variable 



SKIPB 



addr,n,r 



addr 



Address of the FET. 



Number of records to skip backward. If n is not specified, 1 is 
assumed. If n=7777778, file is rewound. 

Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section). 
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SKIPFB (640) 

SKIPFB causes the specified file to be backspaced n files from the current position. If the 
skip count specified is 777777 8 , the file is rewound. If the BOI of the file (or the load 
point of the current volume in a multivolume tape file) is encountered before backspacing is 
complete, even if the file was originally at BOI, a rewind status (05x) is returned. 
Otherwise a skip status (74064 It) is returned. 

Macro format: 

Location Operation Variable 
SKIPFB addr,n,r 

addr Address of the FET. 

n Skip count; if n is omitted, 1 is assumed. 

r Auto recall option; if any value is specified for r, control is not 

returned to the user program until the operation is complete. 

DATA TRANSFER MACROS 

NOS provides a set of macros to assist you in manipulating the following types of data. 

• Data that is to be processed after being read from a file. 

• Data that is to be written on a file after being processed. 

To use the data transfer macros with the Input/output macros, the user program must define 
FETs, input/output circular buffers, and working buffers. The data transfer macros enable 
the user program to copy data from the working buffer to the circular buffer and vice versa 
without having to be concerned with the circular buffer FET pointers. The macros and the 
associated common decks perform all activities involved with the FET pointers. Figure 3-3 
illustrates a typical buffer arrangement. 

In figure 3-3, to copy data from the working buffer to the circular buffer a write data 
transfer macro is used. In this case, data starting at the address of the working buffer is 
copied to the circular buffer starting at address IN. To copy data from the circular buffer 
to the working buffer, a read data transfer macro is used. Then data starting at the 
circular buffer address OUT is copied beginning at the address of the working buffer. 

The working buffer is usually signficantly smaller than the input/output buffer. 

The user program must issue the input/output functions to initiate reading or writing 
between the input/output buffer and the device. However, once the function is issued, the 
common decks called by the data transfer macros initiate the subsequent input /output 
requests required to maintain the data flow until the Initial function is completed; that 
is, until an EOR, EOF, or EOI is encountered, depending on the CIO function. 



tThis status response is returned for a coded FET. The status response for a binary FET 
ends In 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section). 
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circular buffer 



file environment table (FET) 



file name 


code and 
status 


parameters 


first 





in 





out 


parameters 


limit 


IBB!! 




limit 



not used 



Figure 3-3. Data Transfer Buffer Arrangement 



Data transfer read macros return the following Information. 

• (XI) = if the transfer to the working buffer is complete. 

• (XI) = -1 if an EOF is encountered when reading the file. 

• (XI) = -2 if an EOI is encountered when reading the file. 

• (XI) > if an EOR is encountered on the file before the transfer to the working 

buffer is complete; this number is the address plus 1 in the working buffer 
of the last word transferred (equal to B6). 

A CIO read function stops transferring data to the Input/output circular buffer when an EOR, 
EOF, or EOI is encountered, unless the CIO function being used specifies a different 
termination condition (for example, READEI or READNS). Depending on the CIO read function, 
the EOR and/or EOF status may not be returned (for example, READEI or READNS). 

Following a data transfer read function, register B6 contains the address plus 1 of the 
working buffer for the last word of data transferred. 
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The following sample program rewinds an input file named 1NP and an output file named OUT 
and copies file INP to file OUT. 



IDENT COPYFIL 
ENTRY COPYFIL 
SYSCOH B1 



ASSEMBLY CONSTANTS. 



IBUFL 
OBUFL 
UBUFL 

r* 


EQU 
EQU 
EQU 

FETS. 


1001B 
2001 B 
100B 


INPUT BUFFER LENGTH 
OUTPUT BUFFER LENGTH 
WORKING BUFFER LENGTH 


I 

INP 



OUT 


BSS 
FILEB 
BSS 
FILEB 




IBUF,IBUFL 

0BUF,0BUFL 




t* 


MAIN PROGRAM. 




COPYFIL 


SB1 

REWIND 

REWIND 


1 


I 




C0P1 


READ 
RECALL 


I 



INITIATE READ OF LOGH 



COP2 READW I,WBUF,WBUFL 

ZR X1,C0P3 IF NOT EOR/EOF 

NG X1,C0P4 IF EOF OR EOI ENCOUNTERED 

* EOR ENCOUNTERED. COPY DATA IN WBUF TO OUTPUT FILE. 

WRITEW 0,WBUF,X1-WBUF WRITE LAST PORTION OF RECORD 

WRITER WRITE END-OF-RECORD 

EQ COP1 INITIATE READ OF NEXT RECORD 



COPS 


WRITEW 


0,WBUF, 




EQ 


COP2 


COP4 


SX1 


X1+1 




NG 


XI ,C0P5 




WRITEF 







EQ 


COP1 



TRANSFER MORE DATA TO WBUF 



IF EOI ENCOUNTERED 

WRITE END-OF-FILE 

INITIATE READ OF NEXT RECORD 



COP5 



ENDRUN 



** 



BUFFERS. 



IBUF 
OBUF 
WBUF 



BSS IBUFL 
BSS OBUFL 
BSS WBUFL 



INPUT BUFFER 
OUTPUT BUFFER 
WORKING BUFFER 



END 



COPYFIL 



3-56 



60459690 A 



In the previous example, if the RECALL function was not specified for the output file the 
following steps could occur. ' 

1. The user program issues the REWIND function. 

2. Since auto recall is not specified, the user program continues to execute. 

3. At SOme PQinfc . fcHp llfipr nnft&rflm -Icoimo T.TD TTtTT.T ,,!..( _I_ __-, * - ± £■- •™— . . . 
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output buffer (OBUF) starting at the current IN pointer in the FET. The WRITEW 
macro advances the IN pointer to reflect the amount of data transferred into the 
buffer . 

4. At this point, the system completes the REWIND function and accordingly updates the 
FET IN and OUT pointers to point to FIRST (empty buffer). This destroys the IN 
pointer updated in step 3. The data placed in the buffer is ignored. 

5. On subsequent EOR operations (WRITER), the same situation could occur if the RECALL 
function were placed elsewhere. 

WRITER 

RECALL must be placed here. 
WRITEW 0,WBUF,WBUFL 



Write requests in the previous example are not issued with auto recall specified because 
other operations (READ, for example) can be performed before it is necessary to have the 
write operation completed. 

In the previous example, if an EOR or EOF mark is not detected, it is not necessary to 

js.~s.„ ^^^esuo uu j.j.j_i. uuc -uipuwoui-put buffer oecause tne aata transfer macros and 

associated common decks detect when the buffer threshold is reached. If this threshold is 
reached, a request is issued to CIO by the common deck. This occurs with the READC, READH, 
READS, and READW macros when the empty space in the buffer exceeds the threshold or with the 
WRITEC, WRITEH, WRITES, and WRITEW macros when data in the buffer exceeds the threshold. 
The threshold used is half the buffer size. That is, if the buffer is less than half full 
a read request is issued; if it is more than half full, a write request is issued. The 
threshold is an empty buffer for read transfers or a full buffer for write transfers if any 
of the following conditions is met: 

1. The data transfer macro is READO or WRITEC 

2. The buffer is smaller than 512 (1000 g ) vordB > 

3. For read transfers, symbol RDX$ is defined and common deck COMCRDW is assembled with 
the program. 

4. For write transfers, symbol WTX$ is defined and common deck COMCWTW is assembled 
with the program. 
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Assuming no EOR or EOF is encountered by the fifth time through the loop, IBOF is less than 
half full since 256 (400s) words were read. The READW function then issues another CIO 
request to transfer data from file I to circular buffer IBUF. On the ninth time through the 
loop, the WRITEW function issues a WRITE request to file since 0B0F is now more than half 
full. 

For the data transfer macros, the common decks required for absolute assemblies, in addition 
to those specified with each macro, are: 

• C0MCCI0 

• COMCSYS 

• COMCWTW for write functions (except WRITEO) 

• COMCRDW for read functions (except READO) 

For relocatable assemblies, these decks are satisfied by default from the library SYSLIB. 
SYSLIB also satisfies the common decks specified with each macro. 

In all of the macros described, the following parameter definitions apply. 

addr Address of the FET. 

buf Working buffer address. 

n Working buffer word count. 



READC 

The READC macro reads one coded line from the input/output buffer to the working buffer. 
Data is transferred until the end of the line (0000 in bits 11 through 0) is sensed or until 
n words are transferred. 

Macro format: 

Location Operation Variable 

READC addr, buf, n 

Common deck required: COMCRDC 
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WRITEC 

The WRITEC macro transfers a coded line Image from the working buffer to the input/output 

Macro format: 

Location Operation Variable 
WRITEC addr.buf 

Common deck required: COMCWTC 



READH 

The READH macro reads a coded line with space fill from the input/output buffer to the 
working buffer. Data is transferred until the end of the line (0000 in bits 11 through 0) 
is sensed or until n words are transferred. 

Macro format: 

Location Operation Variable 

READH addr,buf,n 

Common deck required: COMCRDH 



WRITEH 

The WRITEH macro writes a coded line, deleting all trailing spaces, from the working buffer 
to the input/output buffer. 

Macro format: 

Location Operation Variable 

WRITEH addr,buf,n 

Common deck required: COMCWTH 



3-59 
60459690 A 



READO 

The READO macro reads one word from the input/output buffer to X6. (Xl)=l if an EOR is 
encountered . 



Macro format : 



Location Operation Variable 



READO addr 



Common deck required : COMCRDO 

WRITEO 

The WRITEO macro writes one word from X6 to the input/output buffer. 

Macro format t 

Location Operation Variable 

WRITEO addr 

Common deck required: COMCWTO 

READS 

The READS macro reads a coded line to a character buffer. The words are unpacked and stored 
in the working buffer, right-justified, one character per word, until the end-of-line byte 
(0000) is detected. If the coded line terminates before n characters are stored, the 
working buffer is blank-filled. If the value specified for n is the complement of the 
working buffer length, the working buffer is not blank-filled. 

Macro format: 

Location Operation Variable 

READS addr ,buf ,n 

Common deck required: COMCRDS 
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WRITES 

The WRITES macro writes a coded line from the character buffer. The character buffer is 
assumed to be one character per word, right- justified. The characters are packed 10 
characters per word. Trailing spaces are deleted before the characters are packed. 



Location Operation Variable 

WRITES addr ,buf ,n 

Common deck required: COMCWTS 



READW 

The READW macro transfers n words to the working buffer from an input/output circular 
buffer. READW reads ahead, in the input/output buffer. This could cause the program to 
abort if the last word address of the input/output buffer is within four words of the FL. 
The n parameter must be specified. 

Macro format: 

Location Operation Variable 

READW addr ,buf ,n 

Common deck required : COKCREW 



WRITEW 

The WRITEW macro copies data from the working buffer to the input/output circular buffer. 
WRITEW writes ahead in the input/output buffer. This could cause the program to abort if 
the last word address of the input/output buffer is within four words of the FL. If n is 
greater than the length of buf , WRITEW reads beyond the end of the working buffer. The n 
parameter must be specified. 

Macro format: 

Location Operation Variable 

WRITEW addr ,buf ,n 

Common deck required : COMCWTW 
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CYBER RECORD MANAGER I/O 

CYBER Record Manager (CRM) consists of a group of routines providing input/ output facilities 
common to several products. User programs written in several higher level languages (for 
example, COBOL and FORTRAN) can communicate with the Record Manager through compiler 
language calls. COMPASS users communicate through Record Manager macros. 

Features of the CRM include the following: 

Consistent error checking. 

Accommodation for label checking. 

Support of several file organizations. 
CYBER Record Manager supports the following file organizations. 

Sequential files in physical order. 

Word addressable files on mass storage with continuous nonblocked data. 

Indexed sequential files in which records are physically and logically ordered by 
symbolic keys. 

Direct access files containing records in fixed length blocks; record location is 
determined by hashing a key to identify a block. 

Actual key files in which each record is stored in a location specified by the key 
associated with that record. 

For a complete description of COMPASS macros, file organizations, and record and block 
formats supported by CRM, refer to the CYBER Record Manager Basic Access Methods and 
Advanced Access Methods reference manuals. 
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LOCAL FILE MANAGER 



Local file manager (LFM) performs requests associated with the control of the files assigned 
to your job. 



The format of the call to LFM is: 

59 40 35 



23 



17 



RA+1 



LFM 



\W 



code 



addr 



R 
code 

fp 
addr 



Auto recall bit. 
Function code. 
Func tion parameter . 
Address of the FET. 



All LFM requests use the following information from the FET. Some requests use additional 
fields; these are noted in the descriptions of the individual requests. 





59 


47 


44 17 


C 


FET + O 


Y/////////////A 


c 


+ 1 


dt 


#, 


e 

P 


m^m%m^%M^ 



lfn Local file name, 

c Completion bit . 

dt Device type, 

ep Error processing bit. 

After the request is completed, the first word of the FET contains the following information. 

59 17 9 

FET+0 

lfn 

at 
c 



lfn 


at 


wm 


c 



Local file name. 

Abnormal termination code. 

Completion bit. 



The common decks required in absolute assemblies for the macros processed by LFM are: 

• COMCLFM. 

• COMCSYS. 
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ERROR PROCESSING 

The user program can issue requests to LFM and have control returned if certain error 
conditions occur. To do this, the error processor bit (ep) must be specified in FET+1. The 
following error codes are returned in the abnormal termination (at) code field of FET+0, 
bits 17 through 10. 



Error Code 


(Octal ) 


1 


2 


3 


4 


5 


6 


7 


10 


11 


12 


13 


14 


1 c 



Description 

File not found 

File name error 

Illegal file type 

File empty 

Magnetic tape subsystem not active 

Reserved for future use 

Illegal equipment 

Equipment not available 

Duplicate file name 

Illegal user access 

Access level not valid for file 

Reserved for future use 

Resource executive (RESEX) 

detected an error 



Error Code 




(Octal) 


Description 


16 


I/O sequence error 


17 


Reserved for future use 


20 


Reserved for future use 


21 


No mass storage available 


22 


Illegal file mode 


23 


FET too short 


24 


GETFNT table too large 


25 


Reserved for future use 


26 


Parameter block busy 


27 


Address out of range 


30 


System error 


31 


Illegal random address 


32 


Reserved for future use 


33 


Illegal file status 



RENAME (000) 

The RENAME function enables the user program to change the name of a file currently assigned 
to the job to the name specified in FET+6 . This does not change the name of the file in the 
permanent file catalog. 

If a file by the new file name already exists, that file Is returned to the system. If the 

I returned file was the primary file (type PTFT) and the old file was local (type LOFT), the 
file type of the new file will be PTFT. File types are listed in appendix E. 

Macro format : 



Location 



Operation Variable 



RENAME 



addr ,nfn 



addr 
nfn 



Address of the FET. 
New file name . 

Value Description 

XI XI contains the new file name . 

0tn er Address of word containing new file name. 

Not specified FET+6 contains the new file name. 



4-2 



60459690 D 



CBTEC (t\n"i\ 

The SETFS function sets the specified status on a file. 
Macro format: 

Location Operation Variable 



SETFS 



addr,fs 



addr 

fs 



Address of the FET for the file. 
File status. 



Value 



AD 



NAD 



Other 



Description 



Auto drop status. A file with auto drop status is 
automatically released when a CLEAR, NEW, OLD, 
RETURN(*), or UNLOAD(*) command is issued, unless 
otherwise specified in the command. All of your files 
have auto drop status set unless you set no auto drop 
status . 

No auto drop status. A file with no auto drop status is 
not automatically released by a CLEAR, NEW, OLD, 
RETURN(*), or UNLOAD(*) command. 

Other file status values are defined in system OPL 
common deck COMSLFD. 



SETFAL (007) 

The SETFAL macro sets the security access level of a local file to the specified level. The 
file must be a mass storage file and may not be a direct access permanent file (use the 
SETPFAL macro for permanent files). This macro requires the system OPL common deck COMSMLS. 

Macro format :t 



Location 



addr 



al 



Operation 



Variable 



SETFAL addr.al 

Address of the FET for the file. 

Security access level to be assigned to the file, al can be either the 
name of the access level to be assigned or the address of a word 
containing the numerical value of a security access level, right- 
justified with binary zero fill. On a secured system, the access level 
specified must be valid for your job (refer to Security Access Levels 
in section 1) and valid for the device on which the file resides. 



tThis macro is not available in SYSTEXT. 
PSSTEXT or call common deck COMCMAC. 



The user program must specify systems text 
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LOCK (010) 

This function enables the user program to prevent writing on a file by setting the write 
lockout bit for the file. The file specified must be a local or primary type file, and must 
not be in execute-only mode. 

Macro format: 

Location Operation Variable 
LOCK addr 

addr Address of the FET. 



UNLOCK (01 1 ) 

The UNLOCK function clears the write lockout bit for the specified file. The file must be a 
local or primary type file, and must not be in execute-only mode. 

Macro format: 

Location Operation Variable 
UNLOCK addr 

addr Address of the FET. 



STATUS (012) 

The STATUS macro determines if a file exists. Zero is returned in bits 11 through 1 of 
FET+0 if the file is not found. A nonzero quantity is returned in bits 11 through 1 if the 
file is found. To determine the current position and status of a file, use STATUS (013). 

Macro format: 

Location Operation Variable 

STATUS addr 

addr Address of the FET. 



4-4 



60459690 B 



STATUS (013) 

This function returns the current position and status of a mass storage or magnetic tape 

f ■? 1 ^ . Th*fe fiintf"! nn nan Ho iicaH t-n dofanalna 4-Tia /*i«i».-£hrtt» »«,* n -r 4-4 <*.-. «j= 4.1.. £ji. *.!__ 1 .£ 
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file, and the device on which it resides. 

The device type is returned in bits 59 through 48 of FET+1 (refer to appendix E); bit 59 is 
set if the device is a nonmass storage and nonalloca table device. 

If the access level bit (bit 39) is set in FET+1, the access level of the file is returned 
in bits 38 through 36 of FET+4. 

The FNT word of the local FNT entry of the file is returned in FET+5; the FST word of the 
local FNT entry of the file is returned in FET+6. The format of the local FNT entry is 
described in the NOS 2 Systems Programmer's Instant. 

NOS does not return the previous function code from bits 11 through of the FST word. 
Instead, the following status information is returned to the FET. 

Bit(s) Description 

11 Set if labeled tape. 

10-9 Not used. 

8 Set if the file is opened. 

7 Set if the file is written on since last opened. 

6 Set if the file is written on since attachment or creation. 

5-4 Not used. 

3-2 If the last operation was a read: 

Incomplete (buffer full). 

1 EOR encountered. 

2 EOF encountered. 

3 EOI encountered. 

If the last operation was a file positioning or write operation: 

Incomplete (no EOR/EOF or buffer exhausted). 

1 Complete. 

1 Set if the last operation was a write. 
Set if the file is not busy. 
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Macro format: 
Location 



Operation 



STATUS 



Variable 



addr,p,t 



addr 
P 



Address of the FET. 

If P is specified, the current position is returned, 
is omitted, LFM function 12 is executed. 



If this parameter 



If T is specified and the FET is at least 11 8 wor ds long, the 
following information is returned to FET+lOs for tape files. 

Bit(s) Description 

58 Set if NOS labels are on tape. 

57 Set if nonstandard labels are on tape. 

56 Set if nine-track tape. 

53-51 Density.t 

50-48 Conversion mode.t 

47-36 Processing options .t 

35-30 Format .t 

29-24 Noise size.t 

23-0 Block size.t 



REQUEST (014) 

The REQUEST function requests operator assignment of equipment to a file. If the file is 

already assigned, the function is ignored. If dt in FET+1 is nonzero, the device assigned 

is of that type. If dt equals MS, a mass storage device must be assigned. The REQUEST 
function cannot be used to assign tape equipment. 

If dt is zero, operator assignment of tape equipment is rejected and operator request for 
equipment continues until an acceptable device is assigned. The LABEL macro should be used 
for tape requests. 

No special validation is required to assign allocatable devices such as mass storage or null 
equipment. All other equipment requires you to be validated to use nonallocatable devices. ft 

If the access level bit (bit 39 of FET+1) is set, the file is created with the access level 
from bits 38 through 36 of FET+4. On a secured system, this level must be valid for your 
job. If the access level bit is not specified, the file is created with no access level on 
an unsecured system; on a secured system, the file is created with your job's current access 
level. 

On a secured system, operator assignment of an equipment that does not support the access 
level of the file is rejected. 



tFor further information about this field, refer to the LABEL macro description. 
ftRefer to the LIMITS command in Volume 3, System Commands. 
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Macro format: 




Location 


Operation Variable 




REQUEST addr,,n 


addr 


Address of the FET. 


n 


If this parameter is 



If this parameter is specified (any value may be used) , the dayf ile 
message indicating the equipment to which the file was assigned will 
not be issued. 

If REQUEST is to be used to checkpoint dumps, FET+7 specifies the checkpoint mode. 

59 53 

FET + 7 



Checkpoint 1 mode indicates that addr is to be used as a checkpoint file 
75 8 
76 8 



Each time a checkpoint dump is taken, the new information is 
written at the BOI of addr. 



Each time a checkpoint dump is taken, the new information is 
written at the previous EOI of addr. 

The user program can alternately write dumps on two checkpoint files by issuing two REQUEST 
macros with cm=75s. If cm=768 for alternate files or if more than two checkpoint files 
are specified, the job step aborts. 



NOTE 



On a secured system, the checkpoint file 
must be assigned an access level equal to 
the upper access level limit of your job. 



REQUEST (015) 

This function assigns a file to a device according to the contents of the device type field 
in FET+1. If the file already exists, the job step aborts. 



The device type (dt) field affects the file's assignment as follows: 
If dt is LFM assigns file to 



TT 
MS 
NE 



The terminal (interactive jobs only) 
Any alloca table mass storage device 
Null equipment 



TFor further information, refer to the description of the CHECKPT macro in section 10. 
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If dt is LFM assigns file to device of preferred residence for 



TP 


Temporary files 


IN 


Input files 


OT 


Output files 


PY 


Primary files 


LO 


Local files 


LG 


Binary (executable) files 



The device of preferred residence for each of these file categories is determined by the 
site and is not subject to user program control. 

If the device type field contains a numeric value of the form 7nnng the file will be 
assigned to EST ordinal nnn. Special validation is required to use this form of the request, 
and nnn must be the EST ordinal of a valid mass storage device. 

The LABEL macro (described in this section) should be used for tape requests. 

If the access level bit (bit 39 of FET+1) is set, the file is created with the access level 
from bits 38 through 36 of FET+4. On a secured system, this level must be valid for your 
job. If the access level bit is not specified, the file is created with no access level on 
an unsecured system; on a secured system, the file is created with your job's current access 
level . 

On a secured system, the system selects a device that supports the access level of the file 
and also meets all of the other specified criteria for the file. If no such device exists, 
the request is rejected. 

Macro format: 

Location Operation Variable 
REQUEST addr,u,n 

addr Address of the FET. 

u If this parameter is specified (any value may be used), the device type 

in FET+1 is the device to which the file is assigned. Absence of this 
parameter causes LFM function 014 to be issued. 

n If this parameter is specified (any value may be used), the dayflle 

message indicating the device to which the file was assigned will not 
be issued . 
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ASSIGN (020) 

This function is used to access a library file. If the file is accessed from a system or 
librar" file the return status code equals • 

The random address of the directory is stored in FET+6. 



This function enables the user program to access user libraries that exist either on files 
attached to the job or the system. The local files are searched first. Because of the 
structure of the system file, the address bias for the directory must be specified. For 
example, if the directory for SYSLIB is specified at random address 2000 (FET+6) on the 
system file, the bias for all entries in this directory is 1777 (FET+7). This is the 
address to be added to the random addresses of all routines in this directory to access the 
routines from the system library. 

If the file specified is a system procedure file, the sign bit in FET+7 is set. If the file 
specified is not a system file, FET+6 and FET+7 are returned as zero. If the file specified 
is a relocatable file, FET+6 and FET+7 are unchanged. 

Macro format: 

Location Operation Variable 
ASSIGN addr.L 

addr Address of the FET. 

L This parameter must be specified. 
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ENCSF (022) 

This function replaces the command file. If the file is not defined, the command file is 
cleared. 



Macro format: 

Location Operation Variable 

ENCSF addr, restore 



addr 



Address of the FET for the file that is to replace the current command 
file. 



restore Address of word containing information on position of the current 
command file; optional parameter. 

If the restore option is selected, the location must be in the following format. 
59 35 29 5 

restore 



cc 
wc 



cc 





current random address 


wc 



Command count. 

Word count position in current sector. 



PSCSF (023) 

This function gives the user program the ability to control the execution of the job 
commands by positioning to the next command in the command file to be executed. 



Macro format :t 



Location 



Operation 
PSCSF 



Variable 
addr 



addr 



Address of the FET for the request. 



FET+6 contains the parameters in the following format: 
FET+6 



59 


47 


23 





W///M. 


cc 


wc 



cc 



Command count . 

Word count from the beginning of the file; if the word count specified 
exceeds the length of the file, the file is positioned at the beginning. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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LABEL (024) 

The LABEL macro assigns a file to magnetic tape and processes labeled and unlabeled tapes. 
LABEL uses the information in FET+lOg through FET+15g to create new and access existing 
seven- or nine-track tape files. The FET information is defined as follows: 





59 


53 


47 


35 


29 


23 


14 


FET +10 


flags 


0- 


cvl po 


f 


noise 


block size 


+ 11 


volume serial number 


'■ J8 


file section number 


+12 


file identifier (first 10 characters) 


+13 


file identifier (last 7 characters) ^ 


file sequence number 


+ 14 


set identifier 


gvn 


generation number 


+15 


expiration date 


creation date 



Parameter 



Word 

(FET+n) 



Flags 



10 



8 



Position Description 

59 Read/write (rw) flag. 

Specifies the type of label 
processing to be performed. This bit 
is set if an OPEN/WRITE is to be 
performed; it is not set if an 
OPEN/ALTER is to be performed. 

For multifile set tapes, if the set 
identifier is specified and a file 
sequence number greater than 1 is 
specified, a POSMF is performed to 
position the tape to the requested 
multifile set. If the file sequence 
number is 9999, write mode is forced 
and the multifile set tape is 
extended. 

58 Label (lb) flag. 

If this bit is set, the tape is 
labeled or is to be labeled. If this 
bit is not set, the tape is unlabeled. 

57 Nonstandard (ns) flag. 

If this bit is set, the tape has or 
is to have nonstandard labels. If 
this bit is not set and bit 58 is 
set, the file is or is to be an 
ANSI-labeled tape. 

56 Tracks (tr) flag. 

If this bit is set, a nine-track tape 
is to be used. If this bit is not 
set, a seven-track tape is to be 
used. It must not conflict with 
track type implied by density and 
conversion mode. 
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Parameter 


(FET+n) 
10g 


Position 
53-51 


Tape 


Description 


Density (den) 


density: 









1 
2 
3 


Installation default. 
556 cpi ( seven-track) 
200 cpi (seven-track) 
800 cpi (seven-track) 








4 
5 


800 cpi (nine-track). 
1600 cpi (nine-track). 
6250 cpi (nine-track). 



Conversion mode (cv) 



Processing option (po) 



10g 50-48 Conversion mode: 

Installation default. 

1 ASCII conversion 
(nine-track) . 

2 EBCDIC conversion, 
(nine- track). 

10g 47-36 Processing options : t 

Bit Set Description 

36 Abort on an unrecoverable 
read or write parity error 
even if the error process- 
ing bit is set. 

37 Do not abort on an 
unrecoverable read or write 
parity error regardless of 
the error processing bit. 

38 Inhibit error processing. 

39 If the tape is mounted with 
write ring in, job process- 
ing is suspended until the 
operator remounts the tape 
correctly. 



40 If the tape is mounted with 
the write ring out , job 
processing is suspended 
until the operator remounts 
the tape correctly. 



TIf neither bit 36, 37, nor 38 is set, abort on read or write parity error only if the 
error processing bit is not set. For further information about these processing options, 
refer to the Equipment/ File Assignment Commands in Volume 3, System Commands. 
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Parameter 
Processing ODtion (no) 



(FET+n) 


Position 




Description 


10o 


47-36 


Bit Set 


v^uawuo ■ 






(Contd) 


Description 



41 Do not unload tape at end of 
usage. 

42 If set, toggles installation 
default setting of the flag 
which controls error correc- 
tion activity in GE (6250 
cpi) write mode. The set- 
ting selected is returned 
after tape assignment is 
complete. If the install- 
ation defaultt is (allow 
error correction) and the 
user program does not toggle 
it or if the installation 
default is 1 (disable error 
correction) and the user 
program toggles it, a value 
of is returned indicating 
that hardware error correc- 
tion is enabled. In this 
mode of operation, the sys- 
tem allows certain types of 
single-track errors to be 
written that can be cor- 
rected when the tape is read 
(on-the-fly correction). 
This is the recommended set- 
ting because it provides 
efficient throughput, error 
recovery, and tape usage 
when writing 6E tapes on 
media that are suitable for 
use at 3200 fci or 6250 cpi. 
If the installation default 
is 1 and the user program 
does not toggle it or if the 
installation default is 
and the user program toggles 
it, a value of 1 is returned 
indicating that hardware 
error correction is disabled. 
The system invokes standard 
error recovery processing 
when an on-the-fly error 
occurs when writing a GE 
tape, thereby reducing the 
amount of data that can be 
stored on the tape. 



tContact installation personnel to determine the default setting. 
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Word 
Parameter (FET+n) Position Description 

Processing option (po) 10 8 47-36 Processing options: 

Bit Set 

(Contd) Description 

42 Only tape that is suitable 
for recording at 6250 cpi 
should be used when this 
mode of operation is in 
effect. Refer to process- 
ing options G and H in 
Volume 3, System Commands, 
for further information. 

43 If set, toggles install- 
ation default setting of the 
flag which controls the 
issuing of tape error mes- 
sages to the user control 
point dayfile.t The setting 
selected is returned after 
the tape assignment is 
complete. If the Install- 
ation default for the set- 
ting is 1 (issue all 
messages to use dayfile) 

and the user program does 
not toggle it or if the 
installation default for 
the setting is (only issue 
first and last messages to 
user dayfile) and the user 
program toggles it, a value 
of 1 is returned, indicating 
that all tape error messages 
are to be issued to the user 
control point dayfile. If 
the installation default for 
the setting is and the 
user program does not toggle 
it, or if the installation 
default for the setting is 
1 and the user program 
toggles it, a value of is 
returned and only the first 
and last tape error messages 
are issued to the user 
dayfile. 

44 Not used. 



tContact installation personnel to determine the default setting. 
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Parameter 



Processing option (po) 



Word 






(FET+n) 


Position 


Description 


10 8 


47-36 


Processing options: 

Bit Set 

(Gontd) Description 



Data format (f) 



10 8 



35-30 



47-45 



These bits define the end-of- 
tape/end-of-reel conditions 
and are defined as follows: 

Bit 47 Bit 46 Bit 45 Optiont 









1 


3 





1 





2 


1 








1 











Default 
option 
selected 
according 
to format 


All other 


combinations are 


illegal. 









Data format (refer to tape data formats 
in Volume 3, System Commands): 

Data 
Value Formatt 



I 

SI 

F 

S 

L 



Noise 



lOg 29-24 Noise size in frames; any block 

containing fewer than the specified 
number of frames is considered noise 
and is discarded by the system (refer 
to appendix J). A noise specification 
of zero causes the default noise size 
to be used. 



Block size (PRU size) 



Volume serial number 



tFor further information, refer 
Conditions, appendix J. 



10g 23-0 Maximum block size in frames (refer to 
appendix J) . 

1 lg 59-24 One to six display code characters that 
uniquely identify a reel of tape (refer 
to ANSI Tape Label Formats , Volume 1 
Label, and VSN Command in Volume 3, 
System Commands). For a VSN of 
SCRATCH, specify a value of all blanks. 

to options 1 through 3 described in End-of-Tape/End-of-Reel 
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Parameter 
File accessibility (fa) 

File section number 

File identifier 

File identifier 

File sequence number 
Set identifier 



Word 
(FET+n) 

lift 



Position Description 

23-18 One display code character indicating 
who may access the tape file.t 

14-0 Fifteen-bit binary file section 
number. f 

59-0 File identifier (first 10 display code 
characters, left-justified with blank 
filD.t 

59-18 File identifier (last seven display 
code characters, left-justified with 
blank fill).t 

14-0 Fifteen-bit binary file sequence 
number .t 

59-24 Six display code characters specifying 
the multiple set identifier, left- 
justified with blank fill.t 

23-15 Nine-bit binary generation version 
number.? 

14-0 Fifteen-bit binary generation 
number .t 

59-30 Five display code characters 

specifying the expiration date. 

29-0 Creation date (two-digit numeric 
display code value for the year 
followed by a three-digit numeric 
display code value for the day within 
the year). 

The specified file is assigned to tape automatically if the volume serial number is 
I specified either in FET+1 1 8 or in a VSN command. If the VSN in FET+1 1 8 is zero and no 
■ VSN command for the file was included, the system requests the operator to assign a unit. 

If dt in FET+1 is MT or NT, a tape unit must be assigned; no other specification is 
allowed. However, if dt is zero, the operator can assign any device and the user must be 
validated for this device. If the operator assigns a tape equipment when dt is zero, only a 
nine-track unit is accepted if the track bit, density, or conversion mode implies 
nine-track, and only a seven-track tape unit is accepted if the density implies seven-track; 
otherwise, either a seven- or nine-track tape unit can be assigned. 

If the access level bit (bit 39) is set in FET+1, the access level in FET+4 is assigned to 
the file. On a secured system, the tape must be mounted on a unit that supports this level. 

For ANSI labeled tapes, FET+llg through FET+15 8 contain the values LABEL uses to process 
HDR1 labels. 



Generation version 
number (gvn) 

Generation number 



Expiration date 
Creation date 



US 

12 8 

13 8 

138 
14 8 

14 8 
14 8 

15 8 
15 8 



tRefer to appendix J. 
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Macro format: 

Location Operation Variable 



LABEL addr 

addr Address of the FET. . 

If a local file with the specified file name already exists (other than a VSN entry for the 
file), no assignment is made and job processing continues. An OPEN or POSMF is not 
performed to reposition an existing tape file. To assign the file to tape, the user program 
should return the existing file to the system before issuing the LABEL request. 

If the file is to be used for checkpoint dumps, the checkpoint mode can be specified in 
FET+7, bits 59 through 56. Refer to the format of FET+7 in the REQUEST macro (function 014). 

Example: 

The following example assigns a file to magnetic tape. The program performs the same 
function in assigning the tape as the following command. 

LABEL, TAPE1,VSN=N0SVSN,P0=R,D=HY,F=I. 

The tape is seven-track, 800 cpi, I format. The program reads file TAPE1. 



BUFL 


ESU 


3001 B 


FET 


BSS 





TAPE1 


FILEB 


BUF,BUFL,LBL 




ORG 


FET+8 


FET8 


VFD 


6/208,3/3,3/0,12/106,6/0,6/0,14/10008 


FET9 


VFD 


36/0HN0SVSN,24/0 




VFD 


60/0 




VFD 


60/0 




VFD 


60/0 




VFD 


60/0 


BUF 


BSS 


BUFL 




LABEL 


FET 




READ 


FET 
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GETFNT (025) 

The GETFNT macro generates a table of entries for local files based on the files' local file 
name table (FNT) entries. 

NOS supports two formats of the GETFNT macro. The format is selected by the setting of bit 
21, FET+lOs. Format A is selected by setting bit 21 to zero; format B is selected by 
setting bit 21 to one. 

Format A allows the user program to optionally specify that file status table (FST) 
information is to be converted to the current current random index or the file length for 
mass storage files, or to the block number for tape files. Format B provides all of the 
information that is optional in format A. 

Format A returns a table of limited length; this length is specified in FET+10 8 . Format B 
fills a buffer whose length is specified in FET+10 8 wlth a number of entries, and allows 
the user program to issue a continuation macro call to obtain further entries. 



NOTE | 



You are encouraged to use format B for all 
new programs and to convert existing programs 
to format B. Format A will not be supported 
in future NOS releases. 
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Macro format :t 



Location 



Operation 



GETFNT 



Variable 



addr 



addr Address of the FET. 
GETFNT obtains its input parameters from FET+lOg, in the following format. 



59 



FET +10 



nf 



41 



23 



17 



sb 



cb 



to 



nf 



sb 



Maximum number of two-word entries to be returned to table. For format 
A, table size must be at least (nf*2+l) words; for format B, table size 
must be at least (nf*2+2) words. Default is 200g entries. 

File type selection bits. A bit set to one implies the corresponding 
file type is selected for entry into the table. All bits set to zero 
indicates selection of all file types. Bit positions and corresponding 
file types are as follows: 



Bit 


File Typett 


Description 


41 


Unused . 


37 


LOFT 


Local. 


36 


SYFT 


System. 


35 


FAFT 


Fast attach file. 


34 


PMFT 


Direct access permanent file 


33 


PTFT 


Primary terminal. 


32 


LIFT 


Library. 


31 


— 


Reserved . 


30 


— 


Reserved . 


29 


QFFT 


Queued file . 


28 


TEFT 


Timed/event rollout. 


27 


PHQT 


Punch queued file. 


26 


PRQT 


Print queued file. 


25 


ROFT 


Rollout . 


24 


1NFT 


Input . 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
ttFile types are explained in appendix E. 
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cb 



Control bits: 
Bit(s) 
23-22 
21 



Significance 



Unused . 



If bit 21 is set, format B is returned; otherwise, format 
A is returned. Bits 18 and 19 are ignored if this bit is 
set. 



ta 



20 If bit 20 is set, checkpoint file entries are returned to 
the table (FET length must be at least llg words). If 
bit 20 is not set (0), the FNT words of checkpoint file 
entries are returned in FET+11 8 , instead of the table 
(FET length must be at least 15g words). 

19 If bit 19 is set, mass storage file FST entries are 

modified with file lengths in bytes 2 and 3. If bit 19 
is not set, the FST entry is modified with random index 
in bytes 2 and 3. Bit 18 must be or bit 19 is ignored. 
Bit 19 is ignored if bit 21 is set. 

18 If bit 18 is set, no modifications are made on the FST 
wr>rd<=. rsf the e^f^S'. Tf K* *■ IS ■• = *i^«- oe«- r^^-*--» rc „-,4- 

modifications are made (such as the block number for tape 
files or that specified by bit 19 for mass storage files). 
Bit 18 is ignored if bit 21 is set. 

Address of table . 



The format A table has the following format. 



ta+1 

ta+(n-1) 
ta+n 



59 





first file entry word 


first file entry word 1 


r ** 


last file entry word 




last file entry word 1 
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Each format A file entry has the following format. 
59 47 

wnrH O 



17 



11 



word 1 



est 



iiniucj type j 



info 



Bit(s) Description 

17 Not used. 

16 Set if extend-only file. 

15 Set if alter-only file. 

14 Set if execute-only file. 

13 Not used. 

12 Set if write lockout is present. 

The file permission mode in which the file was attached is represented 
by the values of bits 16, 15, 14, and 12, as follows: 



Mode 



Bits Set 



type 



status 



Write 




None 


Read 




12 


Append 




16 


Execute 




14, 12 


Modify 




16, 15 


Read, allow 


modify 


16, 15, 12 


Read, allow 


append 


16, 12 


Update 




15 


Read, allow 


update 


15, 12 


File type. 






Value 






(Octal) 




Description 


7 


Rollout. 




10 


Library. 




11 


Primary 


terminal. 


12 


Direct access permanent file 


13 


Fast attach. 


14 


System. 




15 


Local. 




16 


Reserved 


. 


17 


Input. 




20 


Queued file. 


Status of file. 






Value 




Description 





1 

2 
3 
4 
5 
6 
7 



60459690 C 



Auto drop status. 
User file privacy status. 
Special system jobfile status, 
CB checkpoint file status. 
CK checkpoint file status. 
Special output file status. 
Application accounting status. 
No auto drop status. 
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est Equipment status table (EST) ordinal to which file is assigned, 
info For tape files (bit 18 of FET+10 8 not set): 

Bit(s) Description 

47-36 MT (display code). 
35-12 block count. 

For tape files (bit 18 of FET+lOg set): 



Bit(s) 


Description 


47-36 


UDT address 


assignment type. 


35-32 


Data format. 






Value 


Format 







I 




1 


SI 




2 


F 




3 






4 


L 


31-30 


Reserved. 




29-12 


Random address of resource file. 


11-0 


Zero. 





For terminal files: 

Bit(s) Description 

47-36 TT (display code). 
35-0 Zero. 

For mass storage files (bit 19 of FET+lOg set): 

Bit(s) Description 

47-36 Zero. 

35-12 Current random index. 

11-0 Zero. 

For mass storage files (bit 19 of FET+lOg no t set): 

Bit(s) Description 

47-36 Zero. 

35-12 File length in sectors. 

11-0 Zero. 
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11 



The format B table has the following format 

59 

ta 

ta+1 
ta+2 

ta+(n-1) 
ta+n 



addr Relative address of the next entry in the local FNT. addr is if the 
entire FNT has been returned. 



Each format B file entry has the following format. 

59 35 

word 

word 1 






addr 


first file entry word 


first file entry word 1 




last file entry word 


last file entry word 1 






17 14 11 



file name 


al 


rsd 


type 


status 


fl 


rb 


sb 



al 
rsd 



type 



Access level (bits 17-15), 
Residence (bits 14-12). 



Bit(s) 



14-13 



12 



Description 
File residence. 

Value Description 

Mass storage . 

1 Tape . 

2 TTY. 

3 Other . 

Set if write lockout is present , 



File type (bits 11-6). 



Value 




(Octal) 


Description 


7 


Rollout . 


10 


Library . 


11 


Primary terminal. 


12 


Direct access permanent file. 


13 


Fast attach. 


14 


System. 


15 


Local. 


16 


Reserved . 


17 


Input . 


20 


Queued file. 
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status Status of the file (bits 5-0). 

Value Description 

Auto drop status. 

1 User file privacy status. 

2 Special system jobfile status. 

3 CB checkpoint file status. 

4 CK checkpoint file status. 

5 Special output file status. 

6 Application accounting status. 

7 No auto drop status. 

fl File length in sectors (mass storage files only; zero for other files). 

rb Random index (mass storage files), or block count (tape files). Zero 
for other files. 

sb 



Status bits 


: 




Bit(s) 




Description 


11-8 


Reserved. 




7-4 


Mode of use allowed for the file. 




Value 
(Octal) 


Descriptiorit 






1 

2 

3 

4 

5 

6 

7 
10 
11-17 


Read. 

Write. 

Modify. 

Append . 

Execute. 

Read (allow modify). 

Read (allow append). 

Update . 

Read (allow update). 

Reserved. 



3-1 Read status (mass storage files only) : 
Value Description 






Incomplete word 


1 


EOR. 


2 


EOF. 


3 


E01. 


4 


BOI. 



Set if last operation was a write. 



tRefer to PFM Macro Parameter Conventions in section 5. 
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Upon return from GETFNT, the FET is as follows: 





59 







+ 10 


io 


+11 


cfnt 


+12 


cfst 


+13 


wUi ill 


+14 


acfst 



cfnt 

cfst 
acfnt 

acfst 



ia is less than zero if an error is encountered (bit 18 of FET+lOg not 
set). 

FNT word of the checkpoint file; cfnt is zero if there is no checkpoint 
file; less than zero if more than two checkpoint files encountered (bit 
20 of FET+10 8 not set). 

FST word of the checkpoint file. 

FNT word of the alternate checkpoint file; acfnt is zero if there is no 
alternate checkpoint file. 

FST word of the alternate checkpoint file. 



The following program example illustrates format B of the GETFNT macro (bit 21 of FET+lOg 
set). This example returns three entries each time GETFNT is issued. A continuation call 
is issued if the addr field of the reply table is not zero, indicating that there are more 
local FNT entries to be returned. 



BUFL EQU 2001 B SUFFER LENGTH 

FET BSS FET FOR FILE1 

FILE1 FILEB BUF,BUFL,<FET=13> 

BUF BSS BUFL BUFFER 

FET10B VFD 12/3,6/, 18/,6/8,18/TADDR SELECT 3 ENTRIES PER REPLY, ALL FILE 

TYPES, AND FORMAT B 

TADDR BSSZ 7 



START SA1 FET10B 

BX6 X1 

SA6 FET+10B 

CALL GETFNT FET 

SYSTEM DMD,TADDR+6,TADDR 

SYSTEM DMD,FET+12,FET 

SA1 TADDR 

NZ X1,CALL 



ENTER VALUES IN FET+10B 



DUMP REPLY TABLE 
DUMP FET 

ISSUE CONTINUATION CALL IF ADDR 
IN FIRST WORD OF TABLE .NE. ZERO 
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PRIMARY (03 T) 

The PRIMARY macro enables the user program to create or change a primary file (refer to 
Volume 2, Guide to System Usage, for a description of primary files). The current primary 
file (if any) Is changed to a local (LOFT) file and the local mass storage file specified in 
FET+0 is made the primary file. If the specified file does not exist, an empty primary file 
Is created. 



Macro format :t 



Location Operation Variable 



PRIMARY addr 



addr 



Address of the FET for the new primary file. 



FILINFO (032) 

The FILINFO macro returns information about a file to a specified reply block. 



Macro format: 



Location Operation Variable 



FILINFO 



addr 



addr 



Address of a five-word reply block. 



Before the FILINFO macro is issued, the first word of the reply block must contain the 
following: 



59 



addr 



17 



local file name 



len 



HI 



len 



Length of parameter block (at least five words). 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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The standard reply block returned has the following format. 
59 47 35 29^ 17 11 



+ 1 
+ 2 
+ 3 
+ 4 



i.a.i <:i. ..„_.. /i««\ 

IWbUI HIS IIUIiiB \l ■ HI 


Sen 


n 


c 


dt 


status 


ft 


EST ordinal 





file length in sectors 





current random address 





reserved 



c 

dt 



status 



Completion bit (set when operation is complete). 

The 12-bit display code of the type of device on which the file resides 
(refer to appendix E). 

If a file is opened but not written on and it is a mass storage file 
that has not been allocated tracks on a specific alloca table device, the 
device mnemonic is binary 0. 



Status bits: 

Bit(s) 

47-24 
23 
22 
21 
20 
19 
18 
17 



16 
15 
14-13 
12 
11 

10 

9 

8 



Description 

Reserved.' 

File at EOI.t 

File at EOF.t 

File at BOl.t 

Labeled tape file. 

Nine-track tape file. 

Seven-track tape file. 

File open; if set, indicates a CIO OPEN function 

has been issued on the file without a subsequent 

CLOSE function. 

File assigned to interactive terminal. 

File on mass storage. 

Reserved. 

File may be executed. 

File in read/allow append mode (or read/allow 

modify mode). 

File in read/allow update mode (or read/allow 

modify mode). 

File may be altered (update, modify, or write mode). 

File may be extended (append, modify, or write 

mode ) . 

File may be shortened (write mode). 

File may be read. 



tFile position is returned for mass storage files only. EOF status is returned if the last 
operation was a read, and EOF was encountered. 
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ft File type in one of the following octal values; 

File Type Value 



Local 





Input 


1 


Queued 


2 


(Reserved) 


3 


Direct access 


4 


(Reserved) 


5 


Primary 


6 


Library 


7 


Other 


77 



For mass storage files, bits 6 through 12 of the status field are set, depending on the file 
permission mode in the file's local FKT entry. For other files, only the write lockout bit 
in the file name table is checked. If the write lockout bit is set, read-only permission is 
assumed. If the write lockout bit is not set, read and write permission is set. Bits 8 
through 12 apply only to mass storage files. If the following permission mode is set in the 
file's local FNT entry, the indicated bits are set in the status field. 

FNT Mode Status Bits Set 



Ttead 6, 12 

Write 6, 7, 8, 9, 12 

Update 6, 9, 12 

Append 6, 8, 12 

Modify 6, 8, 9, 12 

Read/allow modify 6, 10, 11, 12 

Read/ allow append 6, 11,12 

Read/allow update 6, 10, 12 

Execute 12 

For example, if read mode is set in the FNT, the user program can read (bit 6 set) or 
execute (bit 12 set) the file. 

Word 4 (addr+4) of the reply block is currently not used; however, it is reserved for future 
expansion of the FILINFO macro. 

The FILINFO macro optionally returns additional information for tape files. If the length 
(len field in addr+0) of the FILINFO reply block is greater than five, tape file information 
is returned corresponding to key values in each word after addr+4. The key words begin at 
addr+5 of the reply block and can be in any order. Keys are set by the user program in bits 

4 through of each key word and are returned unaltered after the request is processed. Bit 

5 of the key word is set, and data fields are zeroed on return if the key is unknown to the 
system or is not applicable to the file type specified in addr+1. Key words with zero keys 
are ignored. 
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The following keys return the corresponding key words. Except where otherwise indicated in 
the descriptions, the values returned are those supplied in the ASSIGN, LABEL, or REQUEST 
function, and may not equal the values actually assigned to the tape file. 



Kevt 



Returned Kev Word for Tane File 



59 



14 8 



11 






















f 




1 


59 










17 11 8 5 





e 


Itype 


dsn 


cv 


2 


59 








24 23 


1211 65 


vsn 


reel 





4 


5? 




47 




23 


11 5 





block size 


po 


noise 


14 



Field 



ltype 



den 



Key 

1 



Bit(s) 



11-6 



18 



11-9 



Tape format : 



Description 



Internal (I). 

1 System internal (SI). 

2 Foreign (F). 

3 Stranger (S). 

4 Long block stranger (L). 

If set, error processing is inhibited (same as bit 
14 in po field). 



17-12 Label type: 



Unlabeled . 

1 Standard label (ANSI 1969 standard). 
14 8 Nonstandard label. 

Tape density: 

1 556 cpi (seven-track). 

2 200 cpi (seven-track). 

3 800 cpi (seven-track) or 800 cpi (nine- 
track) . 

4 1600 cpi (nine-track). 

5 6250 cpi (nine-track). 



tThe symbols for each key value are defined in common deck COMSLFM. 
60459690 D 
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Field Key 
cv 2 



Bit(s) 



8-6 



reel 



block 
size 



14 8 



59-24 



23-12 



47-24 



po 



14 8 



23-12 



14 



8 



11-6 



Description 
Conversion mode:t 

BCD conversion (seven-track). 

1 ASCII conversion (nine-track). 

2 EBCDIC conversion (nine-track). 

Volume serial number of the currently mounted 
magnetic tape. This is the actual VSN, not the 
value from the VSN or LABEL command. 

Logical reel number of the currently mounted 
magnetic tape. Corresponds to the ANSI standard 
file section number. 

Maximum block size in central memory words. Always 
1000 octal for I and SI format tapes. For F format 
tapes, the block size is calculated from the FC or 
C parameter value specified on the tape assignment 
command (refer to Volume 3, System Commands). For 
S and L format tapes , the block size returned is the 
size used on the last CIO operation, as determined 



It- V>1c<lr 






sirs field in the FTST 



or CIO buffer size (refer to appendix J). The field 
is zero If no previous CIO function has been issued 
on the tape file. Refer to appendix J for further 
information. 

Processing options. Refer to the description of 
the po field for the LABEL macro in section 4. The 
12 bits in each field have the same respective 
definitions. If po bit 18 (corresponding to po bit 
42 for the LABEL macro) is set upon return from the 
FILINFO macro, GCR hardware write error correction 
is disabled. 

If po bit 19 (corresponding to bit 43 for the LABEL 
macro) Is set upon return from the FILINFO macro, 
the Issuing of all error recovery messages to the 
user dayfile is enabled. 

Noise size in frames. 



If the specified file is not local to your job, words 1 through 4 of the parameter block are 
cleared. All other fields (including words containing keys) are unchanged. 



t Conversion mode of labels (if any) and coded data (if any), 
the data on the tape is coded or binary. 



This does not indicate whether 
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PERMANENT FILE MANAGER 



Permanent file manager (PFM) processes all permanent file requests. The format of the RA+1 
call to PFM is as follows: 



59 



40 35 



23 17 



^[R 



^ 



RA+1 



PFM 



code 



Qddr 



R 

code 

addr 



Auto recall bit. 
Function code. 
Address of the FET. 



The FET used by all PFM requests is formatted as follows. The mnemonics (CFSN, for example) 
are defined in common deck COMSPFM. The length of the FET is defined by the symbol CFLM. 



59 56 53 



45 



38 35 31 29 



23 



17 



FET + O 
+ 1 
+ 2 
+ 3 
+ 4 
+ 5 
+ 6 
+ 7 
+10 
+ 11 
+ 12 
+13 
+14 
+15 
+16 
+ 17 



Itn 



W//////////// 



If n 



al 



2 CFSN 



first 



in 



out 



limit 



CATLIST continuation doto 



categories 

Y//////////////////////////A 



permanent file name (pfn) 



, user nome lun) 

yzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzza 



dn 



ct 



X/////7///// 



file password (pwd) 



erad 



user control word (ucw) 



packname (pn) 



im 



new file name (nfn) 



z 



unit 



xt 




pr 



br 



V 



'A 



CFCN 

CFPN 
CFCT 
CFMD 

CFOU 

CFPW 

CFUC 

CFPK 

CFNF 



fCFPR 
CFBR 
CFSS 
CFAP 



lfn 
dt 
sa 
up 
ep 
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Local file name (left-justified, zero fill). 

Device type. 

Suppress address on error messages (bit 46). 

User processing bit (bit 45). 

Error processing bit (bit 44), 
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rt Real-time processing bit (bit 43). 

a Access level processing bit (bit 39). 

len FET length minus 5. 

first FIRST parameter for file's circular buffer. 

in IN parameter for file's circular buffer. 

out OUT parameter for file's circular buffer. 

al Security access level. 

limit LIMIT parameter for file's circular buffer. 

categories Security access category set (refer to SETPFAG macro). 



pfn 



m 

un 

dn 

s 

pwd 

erad 

ucw 

pn 

unit 

nfn 

xt 

pr 

br 

ss 



Permanent file name (left-justified, zero fill); if pfn is zero, lfn is 
used as the permanent file name. 



Special request subf unction. 

iiie category prefer to Permission Modes, File Categories). 
File access mode (refer to Permission Modes, File Categories). 
Alternate user name. 

Device number for CATLIST option (range is 1 to 77s). 
Number of PRUs (octal) desired for the file. 
Optional file password (left-justified, zero fill). 
Error message return address . 
User control word. 
Pack name of auxiliary device . 
Number of units of multiunit device. 
New file name (refer to CHANGE macro). 
Expiration term or date for password or permit. 
Preferred residence for file (bits 59-57). 
Backup requirement for file (bits 56-54). 
Interactive subsystem asociated with file (bits 53-48). 
ac Alternate user CATLIST permission (bits 47-46). 
For a more detailed description of the FET, refer to the discussion of the FET in section 2. 
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After a request to PFM is complete, the first word of the FET contains the following 
information. 

5? 17_ 

FET+O 



Ifn 


ot 


WM 



lfn Local file name. 

at Abnormal termination code. 

c Bit is set to 1 upon completion of the request. 

The FET length may be five words, if no special options are required, or up to 20g words, 
depending on the special options required. 

When a PFM macro request is processed, the parameter values specified are placed in their 
corresponding fields in the FET. 

On a macro call, the register XI may be used to specify the permanent file name (pfn); the 
register X2 may be used to specify the file password (pwd); and the register X3 may be used 
to specify the alternate user name (un). After the macro is processed, the register X2 
contains the address of the FET. 

The address of the FET must be supplied in the addr parameter. The call to PFM must be made 
with the auto recall bit set (the PFM macros automatically do this). 

The system OPL common decks required for an absolute assembly of a program containing PFM 
requests are COMCPFM and COMCSYS. In order to use the mnemonics defined for PFM FET 
addresses, PFM addresses, permission modes, file categories, or error codes, the system OPL 
common deck COMSPFM is required for absolute or relocatable assemblies. Function mnemonics 
are specified in the macro descriptions. If the al parameter is specified on a SAVE, 
DEFINE, or SETPFAL macro, the system OPL common deck COMSMLS is required. 

On a secured system, your job may not access a permanent file unless it is validated for the 
access level and access category set of the file. For an alternate-user access, such an 
invalid access attempt is treated as a file-not-found error; for an access to one of your 
own files, it is treated as a security conflict (refer to section 1 for a description of 
security conflict processing). 

ALTERNATE USER ACCESS PROCESSING 

Another user can access one of your permanent files only if you explicitly allow it. There 
are two ways you can allow alternate user access : 

• By declaring the file to be a public or semiprivate file. These types of files may 
be accessed by all users in your family; the users may only access the file in the 
mode you specify (and in those modes that are subsets of the specified mode; refer 
to PFM Macro Parameter Conventions in this section for a description of the 
hierarchy of file access modes). 

• By permitting a specific user to access the file with a particular access mode (by 
using the PERMIT command or macro). This may be done on a private or semiprivate 
file; on a semiprivate file, the access mode specified by PERMIT overrides the 
default semiprivate access mode for the file. An expiration date may be assigned to 
each permit entry; when this date is reached, the specified user is no longer able 
to access the file. 
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In addition, you may assign a password to each of your files. An alternate user must 
specify this password in order to access the file. This password may also have an 
expiration date; when this date is reached, alternate users are no longer able to access the 
file. 



ERROR PROCESSING 

The user program can issue requests to PFM and have control returned if certain error 
conditions occur. To do this, the error processing bit (ep) must be specified in FET+1 . 
The error codes are returned in the abnormal termination (at) code field of FET+0 (bits 17 
through 10). If the user program specifies erad in FET+12 8 , the error message is returned 
at this address instead of being issued to the user's dayfile. A maximum of three central 
memory words are returned. System errors are issued to the system and error log dayfiles 
regardless of the erad specification. 

The following error codes are returned in the abnormal termination code field. It is 
recommended that the error code mnemonics defined in common deck COMSPFM be used in testing 
these error conditions. The mnemonics are qualified by symbol ERRMSG. For example, to set 
the B7 register to the value of the FBS mnemonic, use the following instruction. 

SB7 /ERRMSG/FBS 

Error 
Codet Mnemonic Description 

1 FBS The specified direct access file is attached with conflicting 

mode (file busy). 

2 FNF One of the following: 

• The specified permanent file could not be found. 

• The specified user name could not be found. 

• You are not authorized to access the specified file. 

• The specified local file could not be found (SAVE, 
REPLACE, or APPEND). 

• An indirect access file request was issued for a 
direct access file. 

• A direct access file request was issued for an 
indirect access file. 

3 EFL The file specified on a SAVE, REPLACE, or APPEND macro 

contains no data. 

4 NMS The file to be saved is not on mass storage; the first track 

of the file is not recognizable. 

5 FAP The user program has already saved or defined a file with the 

name specified. 
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Error 
Codet 



7 
10 

11 



12 



13 



14 
15 



Mnemonic 

TT7T 

FNE 
IUA 

IDR 



FTL 



ILR 



PFN 
DAD 



Description 

n 4- t- rxm rx 4- rt A ¥ rt Jnf l'rtfl O f41fl *" T-» ra t" TO n/"lt" Q 

local file. 

File name contains illegal characters. 

You are not validated to create direct access or indirect 
access files or to access auxiliary devices. 

The device type (r parameter in macro calls) specified on a 
request for an auxiliary device cannot be recognized or does 
not exist in the system. 

If the removable auxiliary device specified by the pn 
parameter is not the same type as the system default, the r 
parameter must be included; if not, this error code is 
returned. 

The local file specified for a SAVE, REPLACE, or APPEND 
request exceeds the length allowed, or the direct access file 
specified for an ATTACH in write, modify, update, or append 
mode exceeds the direct access file length limit for which 
the user is validated. 

One of the following: 

• Illegal function code passed to PFM. 

• Illegal permit mode or catalog type specified. 

• CATLIST request has permit specified without a file 
name. 

• PERMIT attempted on a public file. 

• DEFINE, CHANGE, or SAVE attempted with alternate user 
name in FET. 

Access to the permanent file device requested is not possible. 

The device on which the file resides may not contain direct 
access files because: 

• The device is not specified as a direct access device 
in the catalog descriptor table. 

• The device is not specified as ON and initialized in 
the catalog descriptor table. 

• The device is a dedicated indirect access permanent 
file device. 



t Codes are given in octal. 
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Error 
Codet 

16 

17 
20 

21 

22 
23 

24 

25 

26 
27 



Mnemonic 
PFA 

DTE 
COF 

COS 

SPN 
IOE 



PRL 

PLE 

PAE 



30 
31 



RSE 
TKL 



Description 

Because a permanent file utility is currently active, the 
operation is not attempted; the user program should retry the 
operation. 

An error occurred in a read operation during a file transfer. 

The number of files in your catalog exceeds the limit (refer 
to the LIMITS command in Volume 3, System Commands). 

The cumulative size of the indirect access files in your 
catalog exceeds the limit (refer to the LIMITS command in 
Volume 3, System Commands). 

The number of PRUs specified via the s parameter on the 
DEFINE macro is not available. 

A request is attempted on a local file that is currently 
active. This error can occur, for example, if the user 
program creates two FETs for the same file and issues a 
second request before the first is complete. 

The job's local file limit has been exceeded by an attempt to 
GET or ATTACH the file. 

The job's mass storage PRU limit is exceeded during 
preparation of a local copy of an indirect access file. 

Permit limit is exceeded for a private file. 

One of the following: 

• An illegal function code was specified. 

• The FET address specified was not within the user 
program's field length. 

• The error message return address specified was not 
within the user program's field length. 

• PFM was not called with auto recall specified. 
The resource executive detected a fatal error. 

No available space remains on the device. 



tCodes are given in octal. 



5-6 



60459690 C 



Error 
Code t Mnemonic Description 

32 FLE The length of a file does not equal the catalog length; the 

action taken depends on the type of request issued. 

Request Action 

GET A local file is created with length being the 
actual length retrieved. 

SAVE If file length is longer than TRT 
specification, file is truncated. 

REPLACE Same as for SAVE. 

33 RIN PERMIT random address error. 

34 DAF The system sector data for the file does not match the 

catalog data. 

35 RPE The same file is found twice during a catalog search. This 

error can occur for APPEND or REPLACE requests after a file 
is found and purged and the catalog search Is continued. 

36 ABT Error flag detected at PFM control point. 

37 MSE An error is encountered in reading or writing a portion of 

the permanent file catalog or permit information. A write 
error encountered during the device to device tansfer of an 
indirect access file. 

Error in data for file. 

Error in permit entries for file. 

Combination of errors 40 and 41. 

An error in the EOI position of the file was detected by 
recovery routines. 

44 NEM PFM detected a fatal RESEX error. PFM does not issue a 

message since RESEX has issued an appropriate message. If 
the error processing (ep) bit is set and the erad field of 
FET+12 contains a valid address, the message RESEX issues is 
returned to that address. 

45-47 — Reserved . 

50 FSE Verification of the file structure or owner identification 

failed. 



40 


EDA 


41 


EPT 


42 


EDP 


43 


FLC 



t Codes are given in octal. 
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Error 




Codet 


Mnemonic 


51 


SSE 


52 


BCS 


53-70 


— 


71 


PPE 



Description 

Error in system sector of indirect access file. 

An invalid catalog or permit sector was detected while 
attempting to access the file. 

Reserved . 

Ihe file does not reside on disk. An unrecoverable error was 
detected when attempting to stage the file to disk from 
alternate storage. 

72 PSI The file does not reside on disk. It is currently being 

staged from alternate storage to disk. 

73 PWE The file must be staged from alternate storage to disk, but 

the subsystem is not currently available to perform the stage 
operation. 

74 FIN The file is currently not available for write, modify, 

update, or append modes of access because a system utility 
has the file attached in utility mode. 

75 — Reserved. 

76 — Reserved . 

77 FEO The local file specified for a SAVE, REPLACE, or APPEND 

request was an execute-only file. 

100 SGD The file does not reside on disk and must be staged from 

alternate storage to disk. 

101 IPA The device number, track, and sector specified as the 

permanent file catalog (PFC) address are invalid. 



102 PVE 



104 INA 



The creation date and time, user index, or alternate storage 
address do not agree with the current PFC contents. 



103 FND Access to a file that does not reside on disk is not 

permitted with the current function. 



A software interlock is currently not available to a request 
specifying both ep and up processing options. 



105 AI0 The disk space for a file cannot be released when the 

alternate storage image is labeled obsolete or the alternate 
storage address is not specified in the PFC. 



t Codes are given in octal. 
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Error 
Code! Mnemonic Description 

106 ASE The disk space for a file cannot be released when a permanent 

error status is set for the alternate storage file image. 

107 FTF File name table (FNT) space is currently not available for a 

rSfiiiPSf rnar Visa nnrn art anrf ti-n nrA^acoi -nn rtni-inno oaf- 

1 — — ■" w bin. b> l&c ts M V l^ii. ^-f* "■"»» 1 " ,, t* ^'■ fc, -'^■ , •■■ t * , ^-*- "o vfcf b j.^ Liu o ^» t. • 

110 ICU Verification of the PFC prohibits the setting of a new 

alternate storage address when the alternate storage address 
is defined and not labeled obsolete. Also, an existing valid 
disk address cannot be replaced in the PFC entry. 

111 PEA The PFM activity count is currently at its limit. This 

condition is reported to the requesting program only if both 
the ep and up processing options are set. 

112 NVX You are not authorized to set a password or permit expiration 

date. 

113 DEM The expiration date or term you specified exceeds the maximum 

expiration term allowed by your site. 

114 JCA Your job is not validated for the access level or access 

category set for the specified file. 

115 LNJ The specified access level is not valid for the calling job. 

116 WDP The local file has a higher access level than the permanent 

file it is replacing or is being appended to, or the local 
file has a lower access level than the job on a DEFINE 
request. You do not have the special authorization to 
perform this operation. 

117 CNJ The specified access category set is not valid for the 

calling job. 

120 LND The local file access level is incompatible with the user's 

master device access level limits. 

121 NVD The specified access level is lower than the current file 

access level, and you are not authorized to lower file access 
levels. 

122 NTD No temporary device could be found with the correct access 

level . 

123 LNF The specified access level on a SAVE request is lower than 

the local file access level. 

i24 TPE The system encountered a temporary error that prevents it 

from moving your file in from alternate storage. Wait and 
try the request again. 



f Codes are given in octal. 
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PFM MACRO PARAMETER CONVENTIONS 

Several methods are available to you for specifying the m, ct, ss, br, pr, and ac parameters 
in PFM macros. You can either specify an alphabetical key or an address that contains an 
integer value that corresponds to a key. If an address is specified, the value must be 
right-justified and zero-filled in a 60-bit word.t The values can be established with the 
mnemonics in the following list . The user program must call common deck COMSPFM to use 
these mnemonics (relocatable or absolute assembly). The valid mnemonics (if any), keys, and 
values for the m, ct, ss, br, pr, and ac macro parameters are listed. 



Parameter Mnemonic 



Key 



Value 
(Octal) 



Description 



File or user permission mode: 



PTWR 



Allows the user program to write , 
read, append, execute, modify, and/or 
purge the file . New information can 
be added within the existing 
boundaries of the file, and the file 
can be extended or shortened. This 
mode can be specified for direct or 
indirect access files. 



PTRD 



Allows the user program to read and/or 
execute the file. This mode can be 
specified for direct or indirect 
access files. 



PTAP 



Allows the user program to append 
information to the end of the file 
(E01). This mode can be specified for 
direct or indirect access files. 



PTEX 



Allows the user program to execute the 
file. This mode can be specified for 
direct or indirect access files. 



PTNU 



Removes permission previously granted 
via PERMIT macros. This mode can be 
specified for direct or indirect 
access files. 



tThese parameters are stored in the FET in right-justified, zero-fill format, except for 
the lfn, pfn, pwd, and nfn parameters which are stored in left-justified, zero-fill format. 
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Parameter Mnemonic Key 
PTMD M 



Value 
(Octal) 



PTRM 



RMt 



PTRA 



RA 



PTUptt 



10 



PTRU 



RU 



11 



Description 

Allows the user program to modify, 
append, read, and/or execute a direct 
access file. Adding new information 
within the existing boundaries of the 
file is legal, and the file size may 
be extended, but the file may not be 
shortened. For an indirect access 
file, this mode allows you to perform 
all the functions of the R (read) mode 
and the A (append) mode. 

Allows the user program to read and/or 
execute a direct access file with the 
implication that another user may 
currently be accessing the same file 
in M (modify), A (append), or U 
(update) mode. For indirect access 
files, this mode is the same as R 
(read) mode. 

Allows the user program to read and/or 
execute a direct access file with the 
implication that another user may 
currently be accessing the same file 
in A (append) mode. For indirect 
access files, this mode is the same as 
R (read) mode. 

Allows the user program to modify, 
read, and/or execute a direct access 
file. Information may be added within 
the existing boundaries of the file, 
but the file size must be maintained. 
For indirect access files, this mode 
is the same as R (read) mode. 

Allows the user program to read and/or 
execute a direct access file with the 
implication that another user may 
currently be accessing the same file 
in U (update) mode. For indirect 
access files, this mode is the same as 
R (read) mode. 



tspecial care should be taken when using modes RM, RA, or RU. Programs using access 
techniques (either CIO or CYBER Record Manager) that do not expect concurrent updating of 
a file may get erroneous results if these modes are used. CRM Advanced Access Methods 
(refer to the CYBER Record Manager Advanced Access Methods Reference Manual) do not expect 
concurrent updating of a file by another user. Therefore, if a file has been attached in 
RM, RA, or RU mode and you are using these access methods, a warning message is issued to 
you stating that the file is bad when, in fact, it is not. 
ttThe CIO function WRITECW cannot be used to perform a write on a file attached in U (update) 
mode. 
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Parameter Mnemonic 



Key 



Value 
(Octal) 



Description 



ct 



FCPR 



FCSP 



File category: 

Private. Private files are available 
for access only by the originator or 
those to whom the originator has 
explicitly granted permission (refer 
to the PERMIT macro). 

Semiprivate. Semiprivate files are 
available for access by all users who 
know the file name, user name, and 
file password. The file owner 
specifies the default permitted mode 
of access for all users. The file 
owner may also specify, via the PERMIT 
macro or command, different 
permissions for different users. 

The system records in the file owner's 
catalog the user name of each user who 
accessed the file, the number of 
accesses, and the date and time of the 
last access. 



FCPB 



PU 



Public. Public files are available 
for access by all users who know the 
file name, user name, and file 
password. The file owner specifies 
the permitted mode of access for all 
users. The system records the number 
of times the file was accessed but 
does not record user names or the last 
access date and time. 
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Value 
Parameter Mnemonic Key (Octal) Description 

ss Subsystem indicator: 





— 


•Q A QTC 

unjiv> 


1 

i 




— 


PORT 


2 




— 


FTNTS 


3 




— 


EXEC 


4 




— 


BATCH 


5 


brt 










BRNO 


N 


1 




BRAL 


Y 


2 




BRMD 


MD 


3 



NULL Null subsystem. 

BriSXG su.bs v s£stn = 



FORTRAN 5 subsystem. 

FORTRAN Extended 4 subsystem. 

Execute subsystem. 

Batch subsystem. 

Backup requirement: 

Backup is not required on a dump tape. 

Backup is required on a dump tape. 

Backup is required on a dump tape only 
if the file is not resident on 
alternate storage. 



prt Preferred residence: 



RSLK L 1 The file will be locked to disk. 

(Special validation is required for 
this option.) 

RSDS D 2 The file should reside on disk at all 

times. 

RSMS M 3 The file should reside on alternate 

storage when it is not being accessed. 

RSNP N 4 No preferred residence for the file. 

ac Alternate CATLIST permission: 

ACNO N 1 Alternate users may not obtain 

information about the file by using 
CATLIST (default value). 

ACYS Y 2 Alternate users may obtain information 

about the file by using CATLIST. 



tlf this parameter is omitted or a value of is specified, PFM uses the installation 
default value. 
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AUXILIARY DEVICE REQUEST 

Unless you explicitly declare otherwise, all of your permanent files reside on family 
devices. As stated in Volume 3, System Commands, you may wish to supplement the mass 
storage provided by your family devices by retaining your files on auxiliary devices. (Not 
all users may be validated to use auxiliary devices.) There are four parameters (pn, r, un, 
and pwd) that uniquely identify file pfn on an auxiliary device. 

• The pn parameter specifies the one- to seven-character system-defined pack name of 
the auxiliary device. The device can be either public or private, as defined by the 
installation. 



• 



The r parameter specifies the type of auxiliary device on which the file resides or 
is to reside. An auxiliary device is any supported device that an installation 
defines as an auxiliary; it need not be a removable device. 

r may be DBn, DDn, Din, DJn, DKn, DLn, DMn, DQn, DV, or DW, as described for 
Equipment Codes in appendix E. 

If you need two or more removable auxiliary devices, or one removable auxiliary 
device and one or more magnetic tapes, at any one time during your job, a RESOURC 
command must be included (refer to Volume 3, System Commands). 

An instaiiation can provide additional continuous storage on a DB, DD, DI, DJ, DK, 
DL, DM, or DQ type device by combining several physical units into one logical 
unit. A device so defined is known as a multiunit device. To specify such a 
device, the r parameter must include the number of units. For example, if four 
844-21 units have been combined as one multiunit device, the r parameter must be 
DI4. If it is not, the job step aborts. 

However, if r is DB, DD, DI , DJ, DK, DL, DM, or DQ but n is omitted, the unit count 
is assumed to be 1 . 

The r parameter is required only if the desired device has a device type different 
from that of the installation-defined default device type, and the installation has 
defined the desired device as removable. However, you can be assured of always 
accessing the proper device by specifying this parameter. If an incorrect value is 
specified for r, PFM error message 11 8 (IDR) is issued. For all PFM macros, if pn 
is specified but the device is not available, the job is aborted. By setting the 
error processing bit (FET+1, bit 44) you can bypass the abort and direct the system 
to make the specified device available. If both the error processing bit and the 
user processing bit (FET+1, bit 45) are set, control is returned to the user program 
when the device is unavailable and error code 14g (PFN) is set in FET+0. 

• The un parameter specifies the one- to seven-character optional user name. If the 
device is public, files are accessed in the same manner as specified for family 
devices; that Is, the un parameter must be included only if you wish to access files 
that another user has explicitly or implicitly permitted you to use. If the device 
is private, there is only one owner. All other users who have the proper validation 
can access files on the device, but the system prevents them from creating files on 
that device . 

• The pwd parameter specifies the one- to seven-character password associated with the 
file. As with files on family devices, the pwd parameter must be included only if 
the originator requires that a password be specified. 
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SAVE (GOT, CCSV) 

The SAVE macro enables the user program to retain a copy of a temporary mass storage file as 



Macro format: 



Location Operation Variable 

SAVE addr ,pf n ,pwd ,ucw , ct ,m, pn , r , f o , ss ,br ,pr ,xt , al , ac 

addr Address of the FET; the local file name must be set in FET+0. 

pfn Address containing the name of the file; name the file is given in the 
permanent file catalog. 

pwd Address containing the password to be placed with the file in the 
permanent file catalog. 

ucw Address containing user control word to be placed with the file in the 
permanent file catalog. If this word exists in the catalog, it is 
returned to FET+13g when the file is accessed (default=0). 



ct 



File category: 
ct 



Description 



P Private file (default value). 
S Semiprivate . 
PU Public file. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 

File mode. This parameter defines the type of access alternate users 
may have for semiprivate or public files . 

m Description 

W Read, write, append, purge, and execute (default value). 

R Read and execute. 

A Append . 

E Execute . 

M Read, append, and execute. 

N None . 

RM Same as R for indirect access files. 

RA Same as R for indirect access files. 

U Same as R for indirect access files. 

RU Same as R for indirect access files. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 
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pn 



Address containing one- to seven-character pack name of the auxiliary 
device on which the file is to be saved. 

Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command 
or macro. This causes the file to saved on your family device. 

Type of auxiliary device on which the file is to be saved (refer to the 
DEFINE macro). 
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fo Family option: 

IP The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family. 

ss Subsystem indicator. This indicator causes automatic subsystem 

selection when the file is retrieved using the OLD macro or command. 

ss Description 

NULL Null subsystem. 

BASIC BASIC subsystem. 

FORT FORTRAN 5 subsystem. 

FTNTS FORTRAN Extended 4 subsystem. 

EXEC Execute subsystem. 

BATCH Batch subsystem. 

Refer to PFM Macro Parameter Conventions in this section for further 
information . 

br Backup requirement. Specifies whether the file is to be backed up on a 
, dump tape when the site dumps permanent files . 

br Description 

Y The file must be backed up on the dump tape. 

MD Backup file on dump tape only if a copy does not exist on 

alternate storage. 
N The file is not to be backed up on the dump tape. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 

pr Preferred residence. Specifies whether you prefer the file to reside on 
disk or on alternate storage. 

pr Description 

M The file should reside on alternate storage when it is not 

being accessed. 
N No preferred residence for the file. 
D The file should reside on disk at all times. 
L The file will be locked to disk. (Special validation is 

required for this option.) 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 
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xt Expiration term or date for password, xt is the address of a word 

containing either the packed expiration date (format: yymmdd, where yy 
is the year minus 1970), or the expiration term, the number of days 
(<7777g) to be added to the current date to determine the expiration 
date. A value of 7777g indicates a nonexpiring password. If this 
parameter is not specified when a password is established, the system 
creates a nonexpiring password* You must be validated to assign a 
permanent file expiration date in order to use this parameter. 

al Security access level of the file. This may be either the name of the 

access level or the address of a location containing the numerical value 
of the access level. System OPL common deck COMCVLC can be used to 
convert access level names to numerical values and vice versa. System 
OPL common deck COMSMLS is required if you specify this parameter. 
Using this parameter sets the access level bit (bit 39 of FET+1). 

If an access level is specified in the al field of the FET rather than 
as a macro parameter, your program must also set the access level bit 
(bit 39 of FET+1). 

On a secured system, any access level specified must be valid for your 
job and for the local and permanent file devices involved. 

ac Alternate CATLIST permission. Specifies whether alternate users may 
obtain information about the file using CATLIST. 

ac Description 

N Permission denied . 
Y Permission granted. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 



C T _ 1 . 

J^A-CllUpiC 1 . 



This example saves local file FILE in the permanent file system as a public file name 
DATA with read permission. The file will be backed up on a dump tape when the site 
dumps permanent files. 

SAVE FILE,PF,,,PU,R,„„Y 



FILE FILEB BUF,BUFL,<FET=16> 

PF VFD 42/0LDATA,18/0 
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Example 2 : 

This example performs the same function as example 1 . 

XTEXT COMSPFM 



SA1 PF 

SAVE FILE,X1,,,FCAT,FM0D,,,,,BACK 



FCAT CON FCPB 

FMOD CON PTRO 

BACK CON 2 

FILE FILEB BUF,BUFL,( FET=16) 

PF VFD 42/0LDATA,18/0 



Example 3: 



In this example, local file TAPE1 is saved in the permanent file system as a private 
file name PTAPE1 with null permission. The subsystem indicator is set to the batch 
subsystem. 

SAVE F,PF,,,P,N,„, BATCH 



F BSS 

TAPE1 FILEB BUF,BUFL,( FET=16) 

PF VFD 42/0LPTAPEl,18/0 
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GET (002, CCGT) 

The GET macro enables the user program to obtain a temporary copy of an indirect access 
permanent file. If a local file by the same name already exists, it is returned as if the 
UNLOAD macro had been issued even if the GET is unsuccessful. The new file is set to 
rewound status. No interlock is provided to prevent other users from obtaining copies of 
the same file simultaneously. 

The local file created by a GET macro call may be an execute-only file, depending on the 
access mode permitted to the user name associated with the user program. PFM returns the 
access mode of the file in the mode field (FET+10 8 , bits through 5) if the FET is long 
enough; the user program can examine this field to determine the access mode. If the FET is 
long enough, the user control word (ucw) is returned to FET+13g, and the subsystem is 
returned to FET+Hg, bits 59-57. Refer to PFM Macro Parameter Conventions in this section 
for a list of access modes and subsystems. 

If the access level bit (bit 39 of FET+1) is set, the access level of the file is returned 
to bits 38 through 36 of FET+4. 



Macro format: 



Location Operation Variable 

GET addr,pfn,un,pwd,pn,r,f o 



addr Address of the FET; the local file name must be set in FET+0. 

pfn Address containing the name of the file; name the file is given in the 
permanent file catalog. 

un Address containing the number of the alternate user whose catalog is to 
be searched for the file specified; if this parameter is specified, the 
permission mode is that which the user has been permitted for private 
files or that specified in the catalog for semiprivate and public files. 



pwd 



Address containing the password of the file; required if unfO and the 
file requires a password. 



pn 



Address containing one- to seven-character pack name of the auxiliary 
device from which the file is to be retrieved. 



Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set the PACKNAM ' command or 
macro. This causes the request to be processed on your family device. 

Type of auxiliary device on which the indirect access permanent file 
resides (refer to the DEFINE macro). 



fo 



Family option: 



IP The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family. 
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PURGE (003, CCPG) 

The PURGE macro enables the user program to remove the specified file from the permanent 
file system. To purge a file in an alternate user's catalog, you must have write permission 
for the file or the file must be a semiprivate or public file with write mode. 



Macro format; 



Location Operation 



Variable 



PURGE 



addr ,un , pwd , pn ,r ,f o 



addr Address of the FET; the local file name must be set in FET+0. If 

FET+lOg contains a permanent file name, that file name is used for the 
PURGE operation. 



un 



Address containing the user name of the alternate catalog for the file 
to be purged. 



pwd 



Address containing the password of the file; required if un^O and the 
file requires a password. 



pn 



Address containing one- to seven-character pack name of the auxiliary 
device on which the file resides. 



Entering the display code character zero (left- justified , binary zero 
fill) in this field overrides the pack name set by the PACKNAM command 
or macro. This causes the request to be processed on your family device. 

Type of auxiliary device identified by the pn parameter (refer to. the 
DEFINE macro) . 



fo 



Family option: 
IP 



The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family. 



An example of the use of this macro is: 



PURGE 



FILEB BUF,BUFL 



These instructions purge permanent file F. 
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CATUST (004,. CCT) 

The CATLIST macro can be used for the following applications: 

• To determine the information about one or more of your own permanent files. 



• To determine the information about one or more files belonging to a specified 
alternate user. You will only be allowed to see information about those files which 
you can access and which the owner has specified you to receive (via the AC = Y 
parameter) . 

• To determine the alternate user information for a specified file that an alternate 
user can access or has accessed in your catalog (permit data) . 

The first type of application is the return of the permanent file catalog entries of all 
your files. If a permanent file name is specified in FET+CFPN, the catalog entry of that 
one file will be returned. 

The format of the permanent file catalog entry is as follows: 

59 56 53 47 44 41 38 35 23 17 11 

FCFN, FCUI 
FCLF, FCBT, FCBS 
FCRI, FCCD 

FCAC, FCMD 

FCCT, FCAM, FCEC, FCEF, 
FCEO, FCAD 

FCKD 

FCRS, FCBR, FCFS. FCUD, 
FCAP 

FCPW 

FCAF, FCAT, FCAA 

FCAL 

FCCN 

FCP1 

FCP2 



FCUC 
FCXW 




file name 
user index 
file length 
track 
sector 
random index 



Permanent file name . 

User index of file creator. 

Length in PRUs of the file. 

Beginning track of file. 

Beginning sector of file (4xxx for a direct access file). 

Random disk address of permit sector. 
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creation date 
and time 



Date and time (yymmddhhmmss in octal) when this file was 
first entered on the permanent file system. The year (yy) is 
the calendar year minus 1970. 



access count 



Count of accesses to file. 



data modification 
date and time 



ct 



Date and time (yymmddhhmmss in octal) when the data in this 
file was last modified. The year (yy) is the calendar year 
minus 1970. For direct access files this field is updated 
when the file is attached in a modifiable mode, whether or not 
the file is actually modified. 

File category (refer to PFM Macro Parameter Conventions for 
further information). 



mode 



ef 



File mode (refer to PFM Macro Parameter Conventions for 
further information). 

Error flag: 



No error. 

1 EOI changed by recovery. 



arror eoae. 



No error. 

1 Error in data for file. 

2 Error in permit entries for file. 

3 Error in data and permit entries for file, 

4 File length error . 
5-7 Reserved. 



dn 



last access 
date and time 

control modification 
date and time 



pr 



br 



Device number (0 through 77g); each device within a family of 
permanent file devices is identified by a device number. 

Date and time (yymmddhhmmss in octal) when this file was last 
accessed. The year (yy) is the calendar year minus 1970. 

Date and time (yymmddhhmmss in octal) when the control 
information (catalog entry and permit record data) for this 
file was last updated. This corresponds to the last time a 
CHANGE or PERMIT command or macro was processed for the file. 
The year (yy) is the calendar year minus 1970. 

Preferred residence for file (refer to PFM Macro Parameter 
Conventions in this section for further information) . 

Backup requirement for file (refer to PFM Macro Parameter 
Conventions in this section for further information). 



Subsystem code for this file (refer to PFM Macro Parameter 
Conventions in this section for further information). 

Alternate CATLIST permission for this file (refer to PFM Macro 
Parameter Conventions in this section for further information) , 
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utility control 
date and time 



file password 
password exp date 

aflags 

alt 

asa 



al 

access 
categories 



charge number 
project number 
user control word 



Date and time (yyraraddhhmmss in octal) used to determine this 
file's candidacy for being dumped by permanent file 
utilities. The year (yy) is the calendar year minus 1970. 

Optional password. 

The date on which the password expires (yymmdd in octal). The 
year (yy) is the calendar year minus 1970. 

Alternate storage flags; used with the asa field and 
meaningful only if the file resides on an alternate storage 
device (as indicated by the alt field); refer to the NOS 2 
Analysis Handbook for a complete description of this field. 

Alternate storage type: 

No alternate storage copy of the file exists. 

1 An alternate storage copy of the file resides on MSF. 

Alternate storage address; meaningful only if an alternate 
storage copy of the file exists (as indicated by the alt 
field); if asa is 0, the file does not reside on alternate 
storage; refer to the NOS 2 Analysis Handbook for a complete 
description of this field. 

File's security access level. 

Each of bits 31 through 0, if set, indicates that the 
corresponding category is in the security access category set 
for the file. The system OPL common deck COMCVLC can be used 
to convert an access category value to an access category name. 

Charge number to which the file will be billed. 

Project number to which the file will be billed. 

User control information (FET+13g). 



The second type of application is a CATLIST of another user's files. The system returns the 
permanent file catalog entries of all the user's files you are permitted to access and that 
are listable by another user. (A file is listable by way of CATLIST only if the owner has 
specified an alternate CATLIST permission [AC=Y].) If a permanent file name is specified in 
FET+CFPN, the catalog entry of the specified file will be returned (provided the file is 
listable by CATLIST and that you are permitted to access it). The following fields are 
cleared before the catalog entries are returned: user index, access level, access category 
set, password, and password expiration date. 



60459690 D 



5-23 



The third type of application is a CATLIST of PERMIT data. All alternate user access entries 
(permit entries) for a specified file are returned. The format of an alternate user access 
entry is illustrated. 



59 




41 


35 


17 





username 


expiration date 




QUO 


i m 


ad 


at 



username 



Alternate user name. 



expiration The date on which the permit expires [yymmdd in octal; the year (yy) is 
date the calendar year minus 1970] . 

aua Number of accesses the alternate user has made to the file (hhmmss in 
octal) . 

ed Bit 41; if set, indicates that an expiration date is present in bits 

17-0 of the first word of the entry. 

m Permission mode (bit 40 set if this was an accounting permit and was not 

created by a PERMIT command or macro; bit 40 clear indicates an explicit 
permit set by PERMIT command or macro; bits 39 through 36 are same as 
mode described In first type of request). 

ad The last date the alternate user accessed the file [yymmdd in octal; the 
year (yy) is the calendar year minus 1970]. 

at The time of day the alternate user last accessed the file (hhmmss in 

octal). 



Macro format :t 



Location Operation Variable 

CATLIST addr,pfn,un,m,pn,r,fo,dn 

addr Address of the FET for the CATLIST function. 

pfn Address containing the file name; if this parameter is omitted, CATLIST 
information for all files in your permanent file catalog (or in the 
catalog specified by un) is returned. 

un Address containing the name of the alternate user catalog to be searched 
for the catalog information. If un is omitted, your own catalog is 
searched. 

m If this parameter is the letter M, alternate user access information for 

file pfn is returned. If this parameter is specified, the pfn is 
required and un is ignored. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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pn Address containing one- to seven-character pack name of the auxiliary 

device that contains catalog information for all users with information 
on that device. 

Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command or 
macro. This causes the request to be processed on your family device. 

r Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro). 

fo Family option: 

IP The pack name specified by a PACKNAM macro or pn parameter is 
ignored. PFM accesses your family. 

dn Request CATLIST of files on device number dn (FET+llg, bits 17 through 
12), Any value may be specified. 

If the status returned in FET+0 (addr parameter of the CATLIST macro), bits 9 through 0, is 
0033 (EOF encountered), the user program should reissue the CATLIST macro after the buffer of 
entries has been processed (refer to example 1). The user program should continue this until 
a status of 1033 (EOI encountered) is returned. CATLIST uses the current random index field 
(FET+6, bits 59 through 30) to keep track of its position for continued calls. If the user 
program changes this field, the results of a CATLIST request may be undefined. 

Information is placed in the buffer starting at IN until (IN=LIMIT-1), at which time buffer 
full (0033) status is set in FET+0. PFM does not process the buffer circularly; therefore, 
the user program must reset (IN=0UT=FIRST) before reissuing the CATLIST macro. 
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The following examples assume that PSSTEXT is specified at assembly. 

Example 1: 

The following program creates a binary file named F with permanent file catalog entries 
for all files in your catalog. (The system OPL must be attached to assemble this 
program.) 





I DENT 


CAT,FWA 




ABS 






ENTRY 


START 




SYSCOM 


B1 


OPL 


XTEXT 


COMSPFM 




ORG 


112B 


FWA 


BSS 





BUFL 


EQU 


1001 B 


F 


FILEB 


BUFF,BUFL 


6 


FILEB 


BUFG,BUFL,FET=10D 


START 


S81 


1 


STA1 


CATLIST 


G 


STA2 


READW 


G,WBUF,NWCE 




NG 


X1,STA3 




WRITEW 


F,WBUF,NWCE 




EQ 


STA2 


STA3 


SX1 


X1+B1 




NG 


X1,STA4 




SA1 


G+1 




SX7 


X1 




SA7 


A1+B1 




SA7 


A7+B1 




EQ 


STA1 


STA4 


WRITER 
ENDRUN 


F 


BUFF 


BSS 


BUFL 


BUFG 


BSS 


BUFL 


WBUF 


BSS 


NWCE 


OPL 


XTEXT 


COMCCIO 


OPL 


XTEXT 


COMCPFM 


OPL 


XTEXT 


COMCRDW 


OPL 


XTEXT 


COMCSYS 


OPL 


XTEXT 


COMCWTW 



TRANSFER CATALOG ENTRY 
IF BUFFER EMPTY 

TRANSFER NEXT CATALOG ENTRY 



IF EOI (CATLIST COMPLETE) 
RESET FET POINTERS 

SET IN=FIRST 

SET 0UT=FIRST 

GET NEXT BUFFER LOAD 



END 
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Example 2 : 

The following example returns all access Information for file DATA013. 
CATLIST F,PF„M 



F 
PF 

Example 3: 



FILEB BUF,BUFL,(FET=10D) 

VFD 42/0LDATA013,18/0 



This example returns a list of all files that you can access by way of CATLIST in the 
catalog of user USERABC. [A file is listable by way of CATLIST only if the owner has 
specified an alternate CATLIST permission (AC=Y).] 

CATLIST F„AUN 



F FILEB BUF,BUFL,<FET=10D) 

AUN VFD 42 /OLUSERAB 0,18/0 

PERMIT (005, CCPM) 

The PERMIT macro enables your program to explicitly permit another user to access a private 
or semiprivate file in your permanent file catalog. If you wish to remove permission 
previously granted, you should select the negate (null) mode. 



Macro format: 



Location Operation Variable 



PERMIT 



addr ,pfn,un,m,pn,r ,fo, ,xt 



addr Address of the FET; the local file name must be set in FET+0. 

P fn Address containing the name of the file; name of the file is given in the 
permanent file catalog. 

un Address containing the user name of the user being granted permission. 

m Mode of permission being granted; if no mode is specified, W (write) is 

assumed. 



R 

A 
E 
N 
M 



Description 

Read, write, modify, append, update, purge, and execute 

(default value). 

Read and execute . 

Append . 

Execute . 

None (negate previous permissions). 

Modify, append, update, read, and/or execute. 
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m_ Description 

RM Read and/or execute, allow simultaneous access in modify, 

append, or update mode. 
RA Read and/or execute, allow simultaneous access in append 

mode . 
U Update . 
R U Read and/or execute, allow simultaneous access in update 

mode. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 

pn Address containing one- to seven-character pack name of the auxiliary 
device on which the specified file resides. 

Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command or 
macro. This causes the request to be processed on your family device. 

r Type of auxiliary device identified by the pn parameter (refer to the 

DEFINE macro). 

fo Family option: 

IP The pack name specified by a PACKNAM macro or pn parameter is 
ignored. PFM accesses your family. 

xt Expiration term or date for permit, xt is the address of a word 

containing either the packed expiration date (format: yymmdd, where yy is 
the year minus 1970), or the expiration term, the number of days 
(<7777g) to be added to the current date to determine the expiration 
date. A value of 7777s indicates a nonexpiring password. If this 
parameter is not specified, the system sets a site-defined default permit 
expiration date. You must be authorized to assign a permanent file 
expiration date in order to use this parameter; also, your site may choose 
to limit the maximum expiration term you may specify. 

An example of the use of this macro is: 
PERMIT F,PF,AUN,A 



BUF,BUFL,(FET=10D) 

42/0LDATA012,18/0 

42/0LUSERABC,18/0 

This allows user USERABC to have append permission to file DATA012. 



F 


FILEB 


PF 


VFD 


A UN 


VFD 
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REPLACE ^006. CCRP) 

The REPLACE macro enables the user program to place a copy of the specified local mass 

storaee file 1n thp nprmflTwsnt f -1 1 o cvct-an ac an -fm4-i*-^ n «- nAAAnn £-ji~ xr .'-ii-.^ 

■-, ■" " — r «^« fc *. — «« «« iuunttt <l^^.coo jlj.j.c» 11 eta niaireci acces 

permanent file with the specified name already exists in the catalog, that file will be 

replaced by the new file placed in the catalog as the same type of file. If the file does 

not exist in the catalog, a new indirect access permanent file is created as if a SAVE 

request naa Deen made, i^ermission information and alternate user access data are not lost 

when the file is replaced. 

Macro format: 



Location Operation Variable 

REPLACE addr,pfn,un,pwd,ucw,pn,r,fo 



addr 
pfn 



pwd 



on 



Address of the FET; local file name must be set in FET+0. 

Address containing the name of the permanent file to be replaced in the 
permanent file catalog. 

Address containing the name of the alternate user's catalog where the 
file resides. 

Address containing the password of the file being replaced (this may be 
required on an alternate user access). 

Address containing user control word to place with the file; bit 59 of 
FET+13g must be set to retain the word with the file in the catalog. 

Address containing one- to seven-character pack name of the auxiliary 
device on which the file is to be placed. 

Entering the display code character zero (left- justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command or 
macro. This causes the file to be replaced on your family device. 

Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro). 



fo 



Family option: 
IP 



The pack name specified by a PACKNAM macro or pn parameter Is 
ignored. PFM accesses your family. 
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AP PEND (007, C CAP) 

The APPEND macro enables a user program to add the contents of the specified local mass 
storage files to che end of the specified indirect access permanent file. The logical 
structure of the two files is retained; that is, EORs and EOFs are appended as wall as data. 
If the working file is appended to a file in an alternate user's catalog, a password must be 
supplied if one is required . 

Macro format: 



Location 



Operation 



Variable 



APPEND 



addr ,pfn ,un ,pwd ,pn ,r ,f o 



addr 



Address of the FET; name of the local file to be appended must be set in 
FET+0. 



pfn 



Address containing the name of the permanent file to which information is 
to be appended. 



Address containing the name of the alternate user whose catalog contains 
the permanent file. 



pwd 



Address containing the password of the file to which information is to be 
appended. This must be specified if un#> and the file requires a 
password . 



pn 



Address containing one- to seven-character pack name of the auxiliary 
device on which the specified permanent file resides. 

Entering the display code character zero (left- justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command or 
macro. This causes the request to be processed on your family device. 

Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro) . 



fo 



Family option: 



IP The pack name specified by a PACKNAM macro or pn parameter is 

ignored. PFM accesses your family; 
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iPPFMn F 



c riLEw bUF 3UFL CPFN = DATA. J 



The structure of file DATA after the APPEND macro is issued is as follows. 



FILE F 



OLD FILE DATA RESULTING FILE (DATA) 



DATA B 


EOR 


DATA C 


EOR 


EOF 


EOI 



DATA A 



EOR 



EOF 



EOI 



DATA A 




EOR 


1 


EOF 




DATA B 




EOR 




DATA C 


. 


EOR 




EOF 




EOI 





DATA 



> OLD FILE F 



tThe permanent file name can be set by FET creation macros as well as being set in the 
permanent file macros. 
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DEFINE (010, CCDF) 

The DEFINE macro enables the user program to create a direct access permanent file. If the 
user program attempts to create a direct access file with the same name as a local file, the 
local file must reside on a legal permanent file device for your user name. If a local file 
with the same name does not exist , an empty file is created on an appropriate device . 



Macro format: 



Location Operation 
DEFINE 



Variable 



addr,pfn,pwd,ucw,r,ct,m,pn,s,fo,br,pr, ,xt,al,ac 



addr Address of the FET. FET+0 must contain the local file name of the file 
to be made a direct access file (name used when the job accesses the 
file). 

pfn Address containing the name of the permanent file entered in the 

catalog. If pfn=0, the contents of FET+0 is used for the permanent file 
name . 



pwd 



ucw 



rt 



ct 



If pwd is specified, the password is retained with the file; all 
alternate users must supply this password when attaching file. 

Address containing user control information, bit 59 of FET+13g must be 
set to retain this data. If this parameter is supplied, this data is 
retained In the catalog entry for the file and returned to FET+138 
when the file is attached. 

Specifies the type of family or auxiliary device on which the permanent 
file resides or Is to reside; r can be DBn, DDn, DE, Din, DJn, DKn, DLn, 
DMn, DQn, DP, DW, or DV as described for Equipment Codes in appendix E. 
If r is not one of these values, the value specified represents the 
address that contains the display code equivalent, left-justified. If 
the device is a multiunit type device (DBn, DDn, Din, DJn, DKn, DLn, 
DMn, or DQn), n is the number of physical units which the installation 
has combined into one logical unit; n is converted from display code to 
octal and placed in FET+14 8 , bits 11 through 0. Also, if r is DB, DD, 
DI, DJ, DK, DM, or DQ but n is omitted, the unit count is assumed to be 
1. If r is not specified, the system default device type (or the device 
type specified in the last PACKNAM macro or command) is used. 

File category: 



ct Description 

P Private file (default value). 
S Semiprivate . 
PU Public file. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 



tlf the file later resides on MSF and then is staged back to disk, it may not reside on the 
device type specified by the r parameter. 
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File mode. This parameter defines the type of access alternate users may 
have for semiprivate or public files. 



W Read, write, modify, append, update, purge, and execute 

(default value). 
R Read and execute. 
A Append . 
E Execute . 
N None . 

M Modify, append, update, read, and/or execute. 
RM Read and/or execute, allow simultaneous access in modify, 

append, or update mode. 
RA Read and/or execute, allow simultaneous access in append mode. 
U Update . 
RU Read and/or execute, allow simultaneous access in update mode. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 

pn Address containing the one- to seven-character pack name of the auxiliary 
device on which the direct access file is to reside. 

Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command or 
macro. This causes the file to be defined on your family device. 

s Address containing the number of PRUs desired for the direct access 

file. The number of PRUs is in octal, right-justified. DEFINE places 
this value in FET+11 8 bits 23 through (CFOU) . 

fo Family option: 

IP The pack name specified by a PACKNAM macro or pn parameter is 
ignored. PFM accesses your family. 

br Backup requirement. Specifies whether the file is to be backed up on a 
dump tape when the site dumps permanent files. 

br Description 

Y The file must be backed up on the dump tape. 

MD Backup file on dump tape only if it does not reside on 

alternate storage. 
N The file is not to be backed up on the dump tape. 

Refer to PFM Macro Parameter Conventions in this section for further 
information . 
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pr Preferred residence. Specifies whether you prefer the file to reside on 
disk or on alternate storage. 

pr Description 

M The file should reside on alternate storage when it is not 

being accessed. 
N No preferred residence for the file. 
D The file should reside on disk at all times. 
L The file will be locked to disk. (Special validation is 

required for this option.) 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 

xt Expiration term or date for password, xt is the address of a word 

containing either the packed expiration date (format: yymmdd, where yy 
is the year minus 1970), or the expiration term, the number of days 
(<7777g) to be added to the current date to determine the expiration 
date. A value of 7777g indicates a nonexpiring password. If this 
parameter is not specified when a password is established, the system 
creates a nonexpiring password. You must be validated to assign a 
permanent file expiration date in order to use this parameter; also, your 
site may choose to limit the maximum expiration term you may specify. 

al Security access level of the file. This may be either the name of the 

access level or the address of a location containing the numerical value 
of the access level. System OPL common deck COMCVLC can be used to 
convert access level names to numerical values and vice versa. System 
OPL common deck COMSMLS is required if you specify this parameter . Using 
this parameter sets the access level bit (bit 39 of FET+1). 

If an access level is specified in the al field of the FET rather than as 
a macro parameter, your program must also set the access level bit (bit 
39 of FET+1). 

On a secured system, any access level specified must be valid for your 
job and for the local and permanent file devices involved. 

ac Alternate CATLIST permission. Specifies whether alternate users may 
obtain information about the file using CATLIST. 

ac Description 

N Permission denied . 
Y Permission granted. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 
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If lfn does not exist at the time the DEFINE request is issued, the device on which pfn 
resides depends on the r and s parameters. 

r s Residence 

Specified Not specified The file resides on the device of type r with the 

most space available . 

Specified Specified The file resides on the device of type r with the 

most space available, provided that device has as 
many PRUs available as specified by the s parameter. 

Not specified Specified The file resides on the device with the most space 

available, provided that device has as many PRUs 
available as specified by the s parameter. 

Not specified Not specified The file resides on the device with the most space 

available . 



Example 1 : 



This defines file F as a read-only public file on a DI device. The name of the entry in 
the permanent file catalog is DATA. (It is assumed that the file did not exist before 
the DEFINE request was issued.) 

DEFINI F,PF,,,DI,PU,R 



F FILEB BUF,BUFL, (FET=9) 

PF VFD 42/0L&ATA,18/0 

Example 2: 

The same operation could be accomplished by the following sequence of instructions. 

SA1 PF 

DEFINE F,X1„,RES,FCAT,R 



F 


FILEB 


BUF,BUFL,(FET=9) 


PF 


VFD 


42/0LDATA,18/0 


RES 


VFD 


12/0LDI,48/0 


FCAT 


CON 


FCPU 


OR. 


XTEXT 


COMSPFM 


Example 3: 







The following sequence defines file DATA. The file will not be backed up on the archive 
tape if it is residing on MSF, and its preferred residence is MSF. 

DEFINE P,PF„„,„„MD,M 



F FILEB BUF,BUFL,(FET=16D) 

PF VFD 42/0LDATA,18/0 
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ATTACH (011,CCAT) 

The ATTACH macro enables your program to attach the specified direct access file to your job. 

A read/write interlock is provided to ensure that only one user at a time accesses the file 
in write mode. Several users may access the file in read mode simultaneously. You should 
return the file as soon as possible to enable other users to access the file. If a local 
file by the same name already exists, it is returned as if the UNLOAD macro had been issued 
even if the ATTACH is unsuccessful. 

If the FET is long enough, the user control word for the file is returned to FET+13s. 

If the access level bit (bit 39 of FET+1) is set, the access level of the file is returned to 
bits 38 through 36 of FET+4. 



Macro format : 
Location 

addr 
pfn 



Operation Variable 

ATTACH addr,pfn,un,pwd,m,pn,r,fo,sr,rt 

Address of the FET. FET+O must contain the local file name of the file 
while attached to the job. 

Address containing the name of the file in the permanent file catalog. 
If pfn is 0, the contents of FET+0 is used for the permanent file name. 

Address containing name of the alternate user catalog on which the file 
resides. 



pwd 



Address containing file password; entered only if un is not and the 
file requires a password. 



pn 



Mode of access desired 
m 
W 



Description 



Read, write, modify, append, update, purge, and/or execute 

(default value). 
R Read and/or execute. 
A Append, update, read, and/or execute. 
E Execute . 
N None . 

M Modify, append, update, read, and/or execute. 
RM Read and/or execute, allow simultaneous access in modify, 

append, or update mode. 
RA Read and/or execute, allow simultaneous access in append mode. 
U Update, read, and/or execute. 
RU Read and/or execute, allow simultaneous access in update mode. 

Refer to PFM Macro Parameter Conventions in this section for further 
information . 

Address containing one- to seven-character pack name of the auxiliary 
device on which the specified permanent file resides (refer to the DEFINE 
macro) . 

Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command or 
macro. This causes the file to be processed on your family device. 
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r Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro). 

fo Family option: 

IP The pack name specified by a PACKNAM macro or pn parameter is 
ignored. PFM accesses your family. 

sr Special request subfunction: 

sr Description 

FAT The file being attached must be a fast attach permanent file. 

IE* Ignore error idle status. 

NF The file being attached may not be a fast attach permanent 
file. 

rt Real-time mode. If this parameter is specified (any value may be used), 
the job step is not delayed for either of the following conditions: 

• The file must be staged to disk from MSF. 

• A permanent file utility is currently active, preventing the 
ATTACH processing. 

If neither of these conditions exists, the rt parameter has no meaning. 
If one of these conditions exists and the rt parameter is not specified, 
the job step is delayed until the operation is complete. If one of these 
conditions exists and the rt parameter is specified, the file is not 
attached; instead, the operation to ensure that the file resides on disk 
is initiated. To complete the attach, another ATTACH macro with or 
without the rt parameter should be issued and the FET status checked to 
ensure that the file was accessed. The function of the rt parameter is 
also accomplished by setting either the up or rt bit in the FET. 

If a file is busy at the time the user program issues an ATTACH macro for the file, the 
system aborts the request. The user program can bypass the abort by specifying error 
processing (the ep bit, bit 44 of FET+1). If ep is set and the file is busy, the system 
returns control to the user program. The user program may then suspend the job by issuing a 
ROLLOUT macro. Normally, when a program issues a ROLLOUT macro to roll out a job subject to 
time/event dependencies, the program must include an address specifying the time period 
and/or event. However, when file busy status is returned, PFM sets up a time/event entry for 
the user program, specifying a rollout time period of 360s seconds. If the file becomes 
available before the time period expires, the job is rolled in at that time. The user 
program should then attempt the ATTACH once again. 

Refer to the ATTACH command in Volume 3, System Commands, for a description of the current 
access modes that result when you attempt to attach an active fileT 



tThe calling program must have an SSJ= entry point. 
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CHANGE (012, CCCG) 

The CHANGE macro allows you to alter the attributes of one of your direct or indirect access 
permanent files without having to recreate the file. The pn and r parameters cannot be used 
to specify a new auxiliary device. They are used only to specify the auxiliary device on 
which ofn resides. Although all attributes that may be specified by parameters on the macro 
may also be specified using the appropriate fields in the FET, the file category, file access 
mode, file subsystem, and user control word must each have the top bit of the field set if 
they are to be specified in the FET for this request. 

Macro format: 

Location Operation Variable 

CHANGE addr ,of n ,nf n ,pwd ,ucw,ct ,m, pn ,r ,f o ,sr , ss ,br ,pr ,xt , ac 

addr Address of the FET; the local file name must be set in FET+0. 

ofn Address containing the old permanent file name. If ofn is not specified, 
the contents of FET+0 is used instead. 

nfn Address containing the new permanent file name. If nfn is not specified, 
no name change takes place . 

pwd Address containing new password; replaces the old password or adds a new 
password if there was none before. If pwd is omitted, the contents of 
FET+18g bits 59 through 18 are used as the new password. If you do not 
wish to change the current password, either FET+12g must be set to 
42/77777777777777B,18/0 or the contents of location pwd must be set to 
42/77777777777777B.18/0. 

ucw Address of word containing user control information; bit 59 of the word 
must be set if this Information Is to be used. If ucw is not specified, 
the contents of FET+13g are used instead; bit 59 of FET+13g must be set 
in that case. 

ct File category: 

ct Value (Octal) Description 

P 40 Private file. 
S 41 Semiprivate. 

PU 42 Public file. 

Refer to PFM Macro Parameter Conventions in this section for further 
information . 
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File mode. This parameter defines the type of access alternate users may 
have for semiprivate or public files. 

Ill Value (Qr1-a]_") noenWtiUnn 



w 40 Read, write, modify, append, update, purge, and 

execute (default value). 
8. 41 Read and execute. 
A 42 Append. 
E 43 Execute . 
N 44 None . 

45 Modify, append, update, read, and/or execute. 

Read and/or execute, allow simultaneous access 

in modify, append, or update mode. 

Read and/or execute, allow simultaneous access 

in append mode . 
U 50 Update . 

Read and/or execute, allow simultaneous access 

in update mode . 



M 

RM 46 

RA 47 



RU 51 



Refer to PFM Macro Parameter Conventions in this section for further 
information. 

P n Address containing the one- to seven-character pack name of the auxiliary 
device on which the file resides. 

Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set the the PACKNAM command 
or macro. This causes the request to be processed on your family device. 

r Address containing the type of auxiliary device identified by the pn 

parameter (refer to the DEFINE macro). 

fo Family option: 

IP The pack name specified by a PACKNAM macro or pn parameter is 
ignored. PFM accesses your family. 

sr Special request subf unction (only one may be specified): 

CE Clear file error code in the catalog entry (refer to the 
CATLIST macro for a description of the catalog entry). 

CP Reset the charge number and project number for the file to 
your job's current charge and project number. 

ss Subsystem indicator. This indicator causes automatic subsystem selection 
when the file is retrieved using the OLD macro or command. 

ss Description 

NULL Null system. 

BASIC BASIC subsystem. 

FORT FORTRAN 5 subsystem. 

FTNTS FORTRAN Extended 4 subsystem. 

EXEC Execute subsystem. 

BATCH Batch subsystem. 

Refer to PFM Macro Parameter Conventions in this section for further 

information . 
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br Backup requirement. Specifies whether the file is to be backed up on a 
dump tape when the site dumps permanent files. 

— Description 

Y The file must be backed up on the dump tape. 

MD Back up file on dump tape only if it does not reside on 

alternate storage. 
N The file is not to be backed up on the dump tape. 

must h be b of ^ reqUlrement ls not t0 be <*anged, the br field of the FET 
So e rmItio P n! ^ *"-** <*™ti«u, i» this section for further 



pr 



xt 



Preferred residence. Specifies whether you prefer the file to reside on 
disk or on alternate storage. 

H Description 

M The file should reside on alternate storage when it is not 

being accessed. 
N No preferred residence for the file. 
D The file should reside on disk at all times. 
L The file will be locked to disk (special validation is 

required for this option). 

If the preferred residence is not to be changed, the pr field of the FET 
must be 0. 

Refer to PFM Macro Parameter Conventions in this section for further 
information. 

IST ^ T? ° r t ate f ° r P assw °rd- xt is the address of a word 
containing either the packed expiration date (format: yymmdd, where yy 
is the year minus 1970), or the expiration term, the numSTof dayS 

A»l a t ° 1 be a * d ?^° the current dat e to determine the expiration 

date. A value of 7777 8 indicates a nonexpiring password. If this 
parameter is not specified when a password is established, the system 
creates a nonexpiring password. You must be validated to assign a 
permanent file expiration date in order to use this parameter; also, your 
site may choose to limit the maximum expiration term you may specify. 
This parameter may not be specified without also specifying the pwd 
parameter unless the file already has a password. 

Alternate CATLIST permission. Specifies whether alternate users may 
obtain information about the file using CATLIST. 



Description 



N Permission denied. 
Y. Permission granted. 



Refer to PFM Macro Parameter Conventions in this section for further 
information. 
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This changes file DATA, on auxiliary device PACK1 to FILE with read-only access. 
CHANGE F,PF,NF,PW,„R,PKN 



F FILEB BUF,BUFL,(FET=UD) 

PF VFD 42 /OL DATA, 18/0 

NF VFD 42/0LFILE,18/0 

PKN VFD 42/0LPACKl,18/0 

PW VFD 42 /-0, 18/0 



Example 2: 



This example changes the backup requirement of file DATA to MD (backup file on dump tape 
only if it does not reside on MSF) and the preferred residence to M (MSF). 

CHANGE DATA„,PW,„„,,,,MD,M 



DATA FILEB BUF,BUFL,(FET=16D> 

PM VFD 42/-0,18/0 
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OLD(021,CCOD) 



The OLD macro enables the user program to obtain a temporary copy of an indirect access 
permanent file and make it the primary file. If a local file by the same name already 
exists, it is returned as if the UNLOAD macro had been issued even if the OLD is 
unsuccessful. If a primary file exists (with a different local file name) before the OLD 
request, it is converted to a local (LOFT) file. The new primary file is set to rewound 
status. No interlock is provided to prevent other users from obtaining copies of the same 
file simultaneously. 

The OLD macro also sets the subsystem index associated with the file. 

The local file created by an OLD macro call may be an execute-only file, depending on the 
access mode permitted to the user name associated with the user program. PFM returns the 
access mode of the file in the mode field (FET+lOg, bits through 5) if the FET is long 
enough; the user program can examine this field to determine the access mode. If the FET is 
long enough, the user control word (ucw) is returned to FET+13s, and the subsystem is 
returned to FET+Hg, bits 59-57. Refer to PFM Macro Parameter Conventions in this section 
for a list of access modes and subsystems. 

If the access level bit (bit 39 of FET+1) is set, the access level of the file is returned to 
bits 38 through 36 of FET+4. 



Macro format: 



Location 



Operation 



Variable 



OLD 



addr , pf n , un , pwd , pn , r , f o 



addr Address of the FET; the local file name must be set in FET+0. 

pfn Address containing the name of the file; name the file is given in the 
permanent file catalog. 

un Address containing the name of the alternate user whose catalog is to be 
searched for the file specified; if this parameter is specified, the 
permission mode is that which the user has been permitted for private 
files or that specified in the catalog for semiprivate and public files. 



pwd 



Address containing the password of the file; required if un^O and the 
file requires a password . 



pn 



Address containing one- to seven-character pack name of the auxiliary 
device from which the file is to be retrieved. 



Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the packname set by the PACKNAM command or 
macro. This causes the file to be saved on the family device of the user 
name associated with the user program. 

Type of auxiliary device on which the indirect access permanent file 
resides (refer to the DEFINE macro). 



fo 



Family option: 
IP 



The pack name specified by a PACKNAM macro or pn parameter is 
ignored. PFM accesses your family. 
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SETPFAC (022.CCAC) 

The SETPFAC macro enables the user program to change the security access category set of a 

narmananl* -r-i I a _ 

[IV.1.IUUUV.UW J.-k^'wV 

If this function is to be performed on a direct access file, the file must not be attached to 
any job. 

Macro format: 

Location Operation Variable 

SETPFAC addr,pfn,cat,pn,r 

addr Address of the FET for the file. 

pfn Address containing the name (left- justified, binary zero fill) of the 
permanent file whose access category set is to be changed. If this 
parameter is omitted, the contents of FET+O are used for the permanent 
file name. 

cat Address containing the new security access category set for the file. 

Each of bits through 31 that is set in this word sets the corresponding 
security access category. The access categories specified must be valid 
for your job (refer to Security Access Categories in section 1). The 
system OPL common deck COMCVLC can be used to convert access category 
names to numerical values and vice versa. 

pn Address containing the one- to seven-character pack name of the auxiliary 
device on which the file resides. 

r Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro) . 
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SETPFAL (023,CCAL) 

The SETPFAL macro enables the user program to change the security access level of a permanent 
file. This macro requires the system OPL common deck COMSMLS. 

If this function is to be performed on a direct access file, the file must not be attached to 
any job. 

Macro format: 

Location Operation Variable 

SETPFAL addr,pfn,al,pn,r 

addr Address of the FET for the file. 

pfn Address containing the name (left- justified, binary zero fill) of the 

permanent file whose access level is to be changed. If this parameter is 
omitted, the contents of FET+0 are used for the permanent file name. 

al The security access level to be assigned to the file, al can be either 
the name of the security access level, or the address of a word 
containing the numerical value of a security access level, right- 
justified with binary zero fill. To convert an access level name to a 
numerical value (or vice versa), use system OPL common deck COMCVLC. The 
access level specified must be valid for your job (refer to Security 
Access Levels in section 1) and valid for the device on which the file 
resides. 

pn Address containing the one- to seven-character pack name of the auxiliary 
device on which the file resides. 

r Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro). 
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The following examples show two different ways to specify an access level using the SETPFAL 
macro. 

— "~ ™t — — * ■ 

In this example, the file's access level is specified in the macro call and therefore 
must be an access level name. 



OPL XTEXT COMSMLS 

OPL XTEXT COMCPFM 

TEST FILEB BUF,101B,(FET=13D) 

BUF BSS 101B 



SETPFAL TEST„LVL3 



Example 2: 



In this example, the file's access level is specified in a separate word and therefore 
must be a numerical value. 



OPL XTEXT COMSMLS 

OPL XTEXT COMCPFM 

TEST FILEB BUF,101B,(FET=13D) 

BUF BSS 101B 

LEVEL CON 3 



SETPFAL TEST„LEVEL 
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CONTROL POINT MANAGER 



L.ontrol point manager i,CPM; enables your program to alter or interrogate parameters in your 
job's control point area. 

Unless otherwise noted, all errors encountered by CPM cause the job step to be aborted; no 
user error processing is available. 

The format of the call to CPM is: 



RA+1 



59 




40 


35 




23 


7 







CPM ^ 


R 


m 


code 


ff 




param 





R Auto recall bit. 

code CPM function code. 

ff Subf unction code for functions 003 and 017. 

param Parameter for the function. 

Common decks required for absolute assemblies by the functions processed by CPM are COMCCPM 
and COMCSYS. For relocatable assemblies, these decks are satisfied by default from the 
library SYSLIB. 

SETPR (001) 

The SETPR macro alters the CPU priority of a job. The CPU priority controls the assignment 
of the CPU to executing jobs that are in memory. If the CPU priority is lower than that of 
other jobs, the job is assigned to the CPU only when jobs of a higher priority do not need 
it. Each service class is assigned an initial CPU priority at system initialization. A 
user job cannot exceed this priority. If the user program requests a priority that exceeds 
this value or 70g (maximum CPU priority), the maximum for the current service class is 
used. 

Macro format :t 



Location Operation 
SETPR 



Variable 



CPU priority; (l<n<708); if n exceeds that for the current service class, 
it is reduced to that value. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck C0MCCMD or C0MCMAC (refer to appendix F). 
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MODE (002) 

The MODE macro defines the error conditions that cause the system to exit from normal 
processing and, on CYBER 180-class models, changes the instruction stack purging status of 
the central processor (refer to the exchange package description in appendix E) . 

When the error specified in a MODE macro occurs, the system sets the appropriate error flag 
and exits from normal processing to perform any error processing required. If an error 
occurs for which the user program did not select the exit mode processing, the system 
ignores the error and continues normal processing. 

Macro format :t 

Location Operation Variable 
MODE m,n,p 

m CPU program error exit mode. 

n This parameter is included for compatibility with earlier versions of 

NGS. The value supplied is ignored. 

p Instruction stack purging (CYBER 180-class models only): 

Normal instruction stack purging. 

1 Extended instruction stack purging. 

The processor will exit when 

this condition occurs If m has one of these octal values 

Address out of range (automatically 1, 3, 5, 7, 11, 13, 15, 17 ft 
selected for model 176) 

Operand out of range (overflow only 2, 3, 6, 7, 12, 13, 16, 17 
on model 176) 

Indefinite operand 4, 5, 6, 7, 14, 15, 16, 17 

Underflow (model 176 only) 10, 11, 12, 13, 14, 15, 16, 17 

The maximum value and default on all models except model 176 is 7, indicating that the 
processor exits on all conditions. The maximum value on model 176 is 17g, indicating that 
the processor exits on all conditions. The default value on model 176 is 7, indicating that 
the processor exits on all conditions except underflow. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 

or call common deck COMCCMD or COMCMAC (refer to appendix F). 
TTOn a model 176 , the address out of range error will always cause a processor exit . 
Therefore, any attempt to disable this type of exit (by specifying a value not included in 
this set) on a model 176 wiU cause an informative message to be issued to the dayfile. 
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Instruction stack purging on CYBER 180-class models can be made normal or extended by 1 
supplying an appropriate value for p. The initial status of stack purging is site- | 

selectable. When stack purging is normal, the processor purges the instruction stack after 

„„„„.. l-inn or. av/.h<nna 4>imn ral-nm 4 ..mri .<n/.nn A A +1 ~r, -.1 k.-ir.,«V. ~r. ~„t- n *.A~A „„„.-,,-„ ~„~A 

CACl<UL^Ug CALL Va^llUUgv juuif, bVbl*l.» JWUI^*, UU\.U11UX b^UUUA Ul.aL*V,Ll, V J. ^ A I- .S UU ^S U 1UC UUm* 4. JT 1 CAU 

instruction. When stack purging is extended, the processor also purges the instruction 
stack after central memory store and conditional branch instructions. Under normal 
circumstances, the CYBER 180-class models processor fetches the contents of the branch | 
destination address prior to executing the branch; this could cause programs that do code I 
modification to fail unless stack purging is extended. 

An attempt to change the stack purging status on any machine other than CYBER 180-class I 
models aborts the program. | 

Null or omitted parameters remain unchanged if fewer than three values are supplied on the 
macro call. Changes made to exit mode or stack purging status remain in effect for 
subsequent job steps unless explicitly changed by a MODE or MACHINE command or a MODE macro. 

Examples : 

Setting m to 6 on all models other than a model 176 selects error exiting on operand out 
of range and indefinite operand. On a model 176, address out of range cannot be 
deselected; it is automatically set by the system. Setting m to 6 or 7 on a model 176 
would yield the same results . 

Setting m to 13g on a model 176 selects underflow and error exiting on operand out of 
range. Setting m to 12g would also accomplish this. 



SETASL (003) 

The SETASL macro allows the user program to specify the account block SRU limit for a job. 
The account block limit is the maximum number of SRUs that can be accumulated by a job. 

If s is greater than or equal to 77770g, the account block SRU limit is set to the maximum 
for which you are validated (infinite if unlimited validation). 

For interactive jobs, this function defines the number of SRUs allowed for a job before 
entry of another CHARGE command is required. For batch or interactive jobs, s represents 
the maximum SRU accumulation between two CHARGE commands or between one CHARGE command and 
the end of the job. The account block limit may not be set to a value less than the current 
job step limit. 

Macro format :t 

Location Operation Variable 



SETASL 



Account block SRU limit. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix F). 
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SETJSL (003) 

The SETJSL macro allows the user program to specify the job step SRU limit for each step of 
a job, including the current job step. The job step limit is the maximum number of SRUs 
that can be accumulated by a single job step. The job step limit must not exceed the 
account block limit (refer to SETASL macro) . 

Each user name and each charge/pro ject number is validated for a maximum SRU limit. If s is 
greater than or equal to 77770g, the job step SRU limit is set to the maximum for which 
you are validated (infinite if unlimited validation). 

Macro format :t 

Location Operation Variable 



SETJSL 



Job step SRU limit. 



SETTL (003) 

The SETTL macro changes the user program's CPU job step time limit for each job step, 
including the current job step. The CPU job step time limit is the amount of time (in 
seconds) that a job step is allowed to use the CPU. 

Each user is validated for a maximum time limit (refer to the LIMITS command in Volume 3, 
System Commands). If t is equal to 777778, the time limit is set to the maximum for which 
you are validated (infinite if unlimited validation). 

Macro format : t 

Location Operation Variable 



SETTL 



Job step time limit ( Kt<77777 8 ) , 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F) . 
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EREXIT (004)t 

NOS allows a user program to specify an error processing routine address . When an error 

r***r*t*TfO Aliy*^-r*C* Tlirf\mram AVO/lltf-Inn f"^A e^Tot-^m A»9*ir>nfi «-1tA *>A<a 4- -(•».>* a*- 4-1~,i4- «*JJw*ma *-— 1 — —..*_ 
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executing. If an additional error occurs while the error processing routine is executing, 
the job step aborts. 



Macro format: 



Location Operation 



Variable 



EREXIT 



addr 



addr 



Address for error exit return. 



As an example, a common procedure is for the program's preset routines to set the error exit 
processing. 



Routine to 
complete 
processing 
when an error 
is encountered 



ERR 



PRS 



SA1 BO READ ERROR RETURN INFO 



ENDRUN TERMINATE PROGRAM 



SUBR PROGRAM PftESET ROUTINE 

EREXIT ERR SET ERROR EXIT ADDRESS 



EQ 



PRSX 



END 



t It is recommended that you use extended reprieve processing (refer to section 10) rather 
than EREXIT wherever possible. 
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The following information is returned to location RA+0 if an error occurs at any time after 
an EREXIT request. 



59 


53 


47 


29 


23 


11 


5 





mo 


aaaooa 


• f 





8SW 






aaaaaa 

ef 

ssw 
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59 


52 


58 


51 


57 


50 


50 


49 


49 


48 


48 



Mode of CPU error exit. For all computer systems except the model 176, 
the mode bit is set for the indicated EM register bit (refer to Exchange 
Package Area, appendix E). 

mo Bit EM Bit Meaning 

CM data error .f 

CMC input error .t 

EEM flag register operation parity error.? 

Indefinite operand. 

Operand out of range. 

Address out of range. 

If an mo bit is not set, the error is due to an illegal instruction. 

For model 176, the following mode bits are set for the indicated PSD 
register bit (refer to Exchange Package Area, appendix E). 

mo Bit PSD Bit Meaning 

CM error condition. 

Not used. 

Not used. 

Indefinite condition. 

Overflow condition. 

LCME block range condition. 

CM block range condition. 

LCME direct range condition. 

CM direct range condition. 

Program range condition. 

The LCME error condition (PSD bit 47) and step condition (PSD bit 39) 
are not mapped to mo. 

CPU address of the job when the error occurred. 

Error flag. Refer to appendix E for a list of error flags. 

Status of sense switches . 



53 


46 


52 


— 


51 


— 


50 


38 


49 


37 


48 


45 


48 


44 


48 


43 


48 


42 


48 


41 



NOTE 



If REPRIEVE is used in the same routine as 
EREXIT, it will take precedence over EREXIT, 
and EREXIT will have no effect. 



tModels 171, 172, 173, 174, 175, 720, 730, 750, 760, 865, and 875 only. 
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ROLLOUT (006) 

The ROLLOUT macro places a job in the rollout queue until a specified event occurs or for a 
fixed period of time. This function may be useful if a program requires a direct access 



Macro format:* 
Location 

addr 



ROLLOUT 



Variable 



addr 



Address containing the time and/or event dependencies; if addr is not 
specified, the job is rolled out without time or event dependencies. 



The following information must be set at location addr: 

59 32 ^ 

addr 



11 






evd 


rtp 



evd 



rtp 



Event descriptor. System programs use the EESET macro tt to make entries 
in a system event table indicating the occurrence of an event. The 
system compares the specified descriptor, evd, with events recorded in 
the table. If a match is detected, the job becomes eligible for rollin. 

evd^O evd and rtp are placed in the control point area 

(TERW). When the job rolls out, the scheduler waits 
for the occurrence of evd or for the time period, 
rtp, to elapse before initiating rollin. Because the 
job may roll in for two different reasons, it is the 
user program's responsibility to verify whether the 
specified event actually occurred. Refer to system 
OPL common deck COMSEVT for a list of events. 

evd=0 The job scheduler uses the value of evd already in 

the control point area. This option allows the user 
to roll out while waiting for a system-specified 
event. One such event is the event that is set up 
when an ATTACH request fails because of a busy file 
(refer to section 5). In this case, the event is the 
return of the file. 

evd=EXTM+00nng Specifies extended time rollout with no event 
(0200nng) dependency. The job rolls out for (77778 x nn) + rtps 
job scheduler delay intervals. The symbol EXTM is 
defined in the system OPL common deck COMSEVT. 

Rollout time period in job scheduler delay intervals (roughly 1 second 
each)ttt where 0<rtp<4095 (7777 8 ). 



If rtp is zero, the scheduler uses the value of rtp already in the control point area. If 
evd is also zero, the job rolls out waiting for a system specified event. If the event goes 
undetected or never occurs, the job rolls in after a system-determined time interval. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 

PSSTEXT or call common deck COMCMAC (refer to appendix F). 
ttObtain a listing of COMCMAC for internal documentation of the EESET macro and the ROLLOUT 
macro and for a description of valid event descriptors. 
tttThe value of the job scheduler delay interval varies from site to site. Contact your 
site analyst to determine the value at your site. 
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SETSSM (010) 

The SETSSM macro enables the user program to set or clear the secure system memory (SSM) 
flag. Setting this flag prevents the dumping of any portion of the job field length. 



NOTE 



While the SSM flag is set, certain system 
requests cannot be performed (refer to 
Security Considerations, section 1). In 
addition, certain system commands cannot be 
issued immediately following a program in 
which the SSM flag is set. Refer to 
Security Control in Volume 3, System 
Commands, for a list of these commands. 



Macro format : t 

Location Operation Variable 
SETSSM p 



Clear SSM flag if lower 12 bits of p are zero; set SSM flag if lower 12 
bits of p are nonzero. 



'This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 
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ONSw(on) 



The ONSW macro sets the sense switches for a program (refer to figure E-l). This allows the 

.._—_ _—___„_ *- A nn 4- n Ti4 ^« ltm-i fn-r- n n <- ■» rt-i-i <n f/\»« milt *-i/i .-11-mn +- -4 nK nfnn« in *■ Tno. ta'K 
U.&CJ. M J. \J K *- *Utlt LAJ SCL OW1UCUC9 A. »u»Jt V/^kJ.V/UO AU1. OUUOCVjUClll. JWU ObCpO iU l_ti*_ J VLS • 

The sense switches reside both in the job's control point area and in bits 11 through 6 of 
RA+0 of the job field length. The field in EA+0 may be used by the user program to check 
sense switch settings; however, changing a bit in KA+O will not cause the bit in the control 
point area to be changed. The field in RA+0 is set equal to the field in the control point 
area at the beginning of each job step, or if an error occurs. An ONSW (or OFFSW) request 
updates both fields separately. 

The bit position specifies the switch to be set. 
Macro format : 



Location Operation Variable 



ONSW 



Switches to be set; 0<n<77g; bit corresponds to switch 1, bit 1 
corresponds to switch 2, and so forth. If a bit is set, the 
corresponding switch is set; for example, ONSW 52g sets switches 2, 4, 
and 6. If n=77g, all switches are set. If n=0, all switches remain 
unchanged. 



OFFSW (012) 

The OFFSW macro enables the user program to clear the sense switches for the job. Refer to 
the description of the ONSW macro for a discussion of sense switch settings. 

Macro format : 

Location Operation Variable 

OFFSW n 

n Switches to be cleared; 0<n<77g; bit corresponds to switch 1, bit 1 

corresponds to switch 2, and so forth. If a bit is set, the 
corresponding switch is cleared; for example, OFFSW 52g clears sense 
switches 2, 4, and 6. If n=77g, all switches area cleared. If n=0, 
all switches remain unchanged. 
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GETJN (013) 

The GETJN function allows the user program to determine the job sequence name (JSN) of the 
job. For the format of the JSN, refer to Volume 3, System Commands. 

Macro format :f 



Location 



Operation 



GETJN 



Variable 



addr 



addr Address to receive job sequence name, lef t- justified , 
The following information is returned to location addr: 



59 



35 



Jtn 



jsn 



Job sequence name for the job. 



GETPR(015) 

The GETPR function allows the user program to determine the CPU priority of the current job. 
Macro f ormat : t 



Location 



Operation 



GETPR 



Variable 



addr 



addr Address where the CPU priority is returned. 

The following information is returned to location addr: 



59 



11 



pr 



CPU priority. 



J This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT or 
call common deck COMCMAC (refer to appendix F) . 
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©ITEM (016) 

The GETEM macro enables the user program to determine under what exit mode the job is 



Macro format :t 

Location Operation Variable 
GETEM addr 

addr Address for return of current exit mode in bits 11 through 0. 

GETASL(017) 

The GETASL macro returns the account block SRU limit for the job (refer to SETASL macro) to 
the specified address. 

Macro format :t 

Location Operation Variable 
GETASL addr 

addr Address to receive account block SRU limit. 
The following information is returned to location addr: 



59 


17 





$ 



Account block SRU limit. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC or COMCCMD (refer to appendix F). 
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GETJSL(017) 

The GETJSL macro returns the job step SRU limit for the current job step (refer to SETJSL 
macro) to the specified address. 



Macro format: t 



Location 



Operation 



GETJSL 



Variable 



addr 



addr Address to receive job step SRU limit. 
The following information is returned to location addr: 



59 



17 



addr 






s 



s Job step SRU limit. 

GETTL(017) 

The GETTL macro returns the time limit for the current job step. 
Macro format: t 



Location Operation Variable 



GETTL 



addr 



addr Address to receive time limit. 
The following information is returned to location addr: 



addr 



59 


17 o 





tl 



tl 



CPU job step time limit (in seconds). 



t This macro is not available in SYSTEXT. The user program must specify systems Lext 
PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix F) . 
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SETLC (022) 

The SETLC macro enables the user program to set the loader control word for subsequent 
loader requests > 

Macro format :t 



Location 



Operation 



SETLC 



Variable 



addr 



addr Address of the loader control word to be set. 
The following information must be set in location addr: 

59 57 53 4ft 48 ZS 17 11 5 



addr 



v fhnc 



y A 



Field Bit(s) 



V 


59 


1 


58 


mc 


57-54 



53 
49 
48 
23-0 



Description 
Map validation bit. If bit is not set, default map option is used. 
If bit is set, global library set is active. 
Map control bits (octal) s 

00 No map is produced. 

01 Statistics and errors. 

02 Block assignments. 

03 Partial map providing statistics, errors, and block 
assignments. 

04 Entry points. 

14 External references and entry points. 
17 Full map providing information given individually by 
control bits 01, 02, 03, and 14. 

Prevents field length reduction after relocatable load. 

If bit is set, request relocatable load from user library. 

If bit is set, program was loaded from a user library. 

Global library set indicators. 



The global library set indicators, contained in the loader control word 
(location LB1W in the user's control point area), are maintained by the SETLC 
macro. The user program should call the GETLC macro before using the SETLC 
macro to avoid destroying the library set information. With the GETLC macro, 
the user program can obtain the current loader control word. The program can 
then change the v, mc, and n fields, and issue a SETLC macro. 



tThis macro is not available to SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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SETRFL (023) 

The SETRFL macro sets the initial central memory and extended memory field lengths for a job 
step. The specified values are used unless the system encounters one of the following: 

• A system routine whose field lengths are specified during system creation. 

• A routine that specifies the amount of CM or extended memory field length required 
in a 54 loader table (refer to CYBER Loader Deference Manual). 

• An MFL or RFL comnand (refer to Volume 3, System Commands) or a subsequent SETMFL or 
SETRFL macro. 

If you do not use the SETRFL function or the RFL command, the operating system determines 
how much field length to assign initially for each job step. 

The CM field length is rounded upward to a multiple of 100 8 words. The extended memory 
field length is rounded upward to a multiple of 1000s words. 

The values specified for CM field length and EM field length cannot exceed the current MFL 
values for the job (refer to the SETMFL macro in this section). 

Macro format :t 

Location Operation Variable 

SETRFL n ,m 



New CM field length parameter. 

New extended memory field length parameter, 



NOTE | 



This request does not change the amount of 
memory currently available for use by the 
user program. To change the amount of 
memory currently available for use , use the 
MEMORY macro. 



TThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F) . 
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GETJCR (024) t 

The GETJCR macro enables the user program to Interrogate the job control registers 
System Commands). The last error flag encountered can also be determined. 



J71cLCi.u J- u J. mac* I 



Location Operation Variable 



GETJCR 



addr 



addr Address for return of the job control registers. 
The following information is returned to location addr: 





59 


53 




35 




7 







addr 


pef 


R3 


R2 


R1 



pef 

R3 
R2 
Rl 



The last error flag encountered (refer to the EREXIT function for the 
values). 

Job control register 3. 

Job control register 2. 

Job control register 1. 



tYou may choose to use the GETJCI macro instead of GETJCR, since GETJCI returns more 

information, 
ft This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 
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SETJCR (025 )t 

The SETJCR macro enables the user program to set the job control registers for the job. 
Refer to the description of the GETJCR macro for the format of the word. 

Macro format :tt. 



Location Operation 



SETJCR 



Variable 



addr 



addr Address of the word containing the job control registers to be set. 
The following information must be set at location addr: 



59 53 



35 



17 



eddr pef 



R3 



R2 



R1 



pef 
R3 
R2 
Rl 



Previous error flag. 
Job control register 3. 
Job control register 2. 
Job control register 1. 



SETSS (026) 

The SETSS macro changes the interactive subsystem under which your job is currently 
executing, provided you are validated for that subsystem. 



Macro format 



:tt 



Location 



Operation 
SETSS 



Variable 



Subsystem ordinal (refer to the TSTATUS macro, section 11, for a 
description of subsystem ordinals). 



tYou should use the SETJCI macro instead of SETJCR. 
ttThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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GETJO (027) 

The GETJO macro returns the job origin code to the specified address. 
Macro format:! 



Location Operation 
GETJO 



addr 



addr Address to receive job origin code. Refer to appendix E for legal job 
origin codes. 

The following information is returned to location addr: 



59 



addr 



jo 



jo 



Job origin code. 



GETJA (030) 

The GETJA macro returns a five-word reply block containing job accounting information 
beginning at the specified address. 

Macro format :t 



Location 



Operation 



GETJA 



Variable 



addr 



addr 



Address of reply block. 



The following information is returned to the five-word reply block beginning at location 
addr: 



59 



41 39 



28 



19 



addr+0 
+ 1 
+ 2 
+ 3 
+ 4 






SRU accumulator (micro units *10) 


CP accumulator (quarter nanounits) 


MS accumulator 


MT accumulator 


PF accumulator 





MP accumulator 


adder accumulator 





AUC accumulator 



Nanounits are calculated as nanoseconds multiplied by the CPU accounting multiplier (refer 
to Resource Accounting in section 5 of the NOS 2 Administration Handbook) . 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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USECPU (031) 



The USECPU macro specifies which central processor is to be used when more than one is 
available . 

Macro format : 



Location Operation Variable 



USECPU 



Description 



Either central processor can be used. 

CPU is to be used (the CPU with functional units on a 6700 or CDC 
CYBER 74-2x). 



CPU 1 is to be used (the CPU without functional units on a 6700 or CDC 
CYBER 74-2x). 



USERNUM (032) 



The USERNUM macro returns the user name under which the job is running to the specified 
address. 



Macro format : 



Location Operation Variable 



USERNUM 



addr 



addr 



Address to receive the user name, left-justified and zero-filled. 
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GETFLC (033, 055) 

The GETFLC macro returns the field length control word from the job's control point area to 
the specified address. 

Macro format : T 



Location 



Operation 



Variable 



GETFLC 



caddr, eaddr 



caddr 
eaddr 



Address to receive the central memory field length control word. 
Address to receive the extended memory field length control word. 



The GETFLC request can include either or both of the addresses. The field length control 
words are returned in the following format (multiply each 12-bit field by 100g for caddr 
or 1000g for eaddr to obtain the actual value). 





59 




47 




35 




23 




1 







and 
eaddr 


mfl 


rfl 


jmfi 


rifl 


fiir 



mfl 



rfl 



jmfl 



rifl 



flir 



Maximum CM or extended memory field length for the current job step. 
This value may be reset with the MFL command (refer to Volume 3, System 
Commands) or the SETMFL macro. 

Initial running CM or extended memory field length for a job step. This 
value is always less than or equal to mfl and is set with the RFL 
command or the SETRFL macro. A value of zero indicates that the system 
controls the field length. 

Maximum CM or extended memory field length for the entire job. The jmfl 
represents the upper bound on. mfl. 

CM or extended memory field length for the job when it is to be rolled 
in. 

CM or extended memory field length increase requested. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 
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PACKNAM (035) 



The PACKNAM (035) request specifies a default pack name and device type for your job. It 
allows the user program to omit the pn and r parameters from PFM requests for files residing 
on the auxiliary device. If a PACKNAM request is in effect and you wish to access permanent 
files on another auxiliary device, you can either specify the pn and r parameters in the PFM 
request or issue another PACKNAM macro. To access permanent files on your permanent file 
family device while a PACKNAM request is in effect, either specify a display code zero as 
the pn parameter in the PFM request or issue another PACKNAM macro with a binary zero pack 
name. 

Macro format :t 

Location Operation Variable 
PACKNAM addr 

addr Address of parameter word. 
Parameter word format: 



addr 



packname One- to seven-character alphanumeric pack name, left-justified, 

zero-filled. If this field is binary zero, any existing pack name and 
device type are cleared. 

dt Three-character alphanumeric device type. The first two characters 

represent the type of auxiliary device (refer to appendix E) ; the third 
character indicates the number of spindles in a multispindle device. If 
the third character is omitted, the default is 1; if the entire field is 
zero, the default is the system pack type (set by the installation). 



59 


17 


packname 


dt 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deckCOMCCMD (refer to appendix F). 
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PACKNAM (036) 

The PACKNAM (036) request returns the default pack name and device type to the specified 
address. 



Macro format :t 



l-lUilCiLiEJH 



Operation Variable 



PACKNAM addr.N 
addr Address to which the pack name and device type are to be returned. 
N Indicates that the pack name and device type are to be returned. 
The following information is returned to location addr: 



59 



addr 



17 



packname 



dt 



packname 



dt 



One- to seven-character alphanumeric default pack name, left-justified, 
zero-filled. (If no pack name is set, binary zero is returned.) 

Three-character alphanumeric default device type. The first two 
characters represent the type of auxiliary device (refer to appendix E); 
the third character indicates the number of spindles in a multispindle 
device. 



GETSS (037) 

The GETSS macro returns the current subsystem ordinal to the specified address. 
Macro format :tt 

Location Operation Variable 



GETSS 



addr 



addr 



Address to receive subsystem ordinal (refer to TSTATUS macro, section 
11, for a description of subsystem ordinals). 



The following information is returned to location addr: 
59 



addr 



2 



Subsystem ordinal. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 

PSSTEXT or call common deck COMCCMD (refer to appendix F). 
ttThis macro is not available in SYSTEXT. The user must specify systems text PSSTEXT or 
call common deck COMCMAC (refer to appendix F). 
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VERSION (044) 

The VERSION macro returns the version name of the operating system (and, optionally, the 
system title line) from central memory to the specified location. 

Macro format : T 



Location 



Operation 



VERSION 



Variable 



addr 



addr Address of word containing macro parameters. 

The following Information must be specified at location addr: 

35 23 17 



59 



addr 



be 



47 



sb 



bp 



M 



waddr 



t If set, indicates that the system title line Is to be returned in 

addition to the operating system version name. 

be Number of bytes (1 to 10 or, if t is specified, 1 to 30) to return from 

source field (CM location containing version name and, optionally, 
system title) . 

sb Byte in source field at which to begin transfer (0 to 9 or, if t is 

specified, to 29); the sum of be and sb must be less than 11 (less 
than 31 if t is specified). 

bp Byte position within receiving field (waddr) at which to begin transfer 

(0 to 4). 

waddr Beginning address of three-word block (seven-word block if t is 

specified) to receive data. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD or C0MCMAC (refer to appendix F) . 
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GETLC (045) 

The GETLC macro returns the loader control word to the specified address . Refer to the 
SETLC macro for the format of the loader control word. 

Macro format : t 

Location Operation Variable 
GETLC addr 

addr Address to receive the loader control word. 

GETGLS (046) 

The GETGLS macro returns the global library set from the job's control point area. Eefer to 
the CYBER Loader Version 1 Reference Manual for a discussion of global library sets. A 
parameter word is used to specify where a list of logical file names is to be placed. 

Macro format : TT 

Location Operation Variable 



GETGLS addr 

addr Address of parameter word. 

Parameter word format: 



addr 



list 



list Beginning address to which the logical file names (left- justified) 

contained in the global library set are written. The value of this 
parameter is updated to the address of the word following the last 
library (list+n+1) upon completion. 



TThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix F). 
TtThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEST or call common deck COMCMAC (refer to appendix F) . 
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The following Information is returned to locations list through list+n: 
59 17 



list + 
+ 1 
+ 2 



list+n 



: t- 



Ifn of first library 



If n of second library 



Ifn of third library 



Ifn of last library 




n 
Ifn 



The number of libraries defined in the global library set minus one, 
The name of a global local library or the name of a system library. 



SETGLS (047) 



.nit OUJ.OX4J niociu cuauits liic usci piugiam lo ueixue tne gxooax xiDrary set indicators In the 
job's control point area. Refer to the CYBER Loader Version 1 Reference Manual for a 
discussion of global library sets. A parameter word specifies where the list of logical 
file names used to define the global library set is located. 

Macro format :t 



Location Operation Variable 



SETGLS 



addr 



addr 



Address of parameter word. 



Parameter word format: 



59 53 

addr 



35 



list 



list Beginning address to which the logical file names (left- justified) 

contained in the global library set are written. The value of this 
parameter is updated to the address of the last library (list+n) upon 
completion. If an error is encountered, list will be the address of the 
Ifn of the library that caused the error. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 
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Before calling the SETGLS macro, locations list through list+n+1 must be as follows: 
59 17 



(itt +0 
+ 1 
+ 2 



!ist + n 



Ifn of first Hhrnru 






Ifn of second library 



Ifn of third library 



■Hi 



Ifn of last library 




n The number of libraries in the global library set minus one. 

MACHID (050) 

The MACHID macro enables the user program to determine the one- or two-character machine 
identification. 

Macro format: t 

Location Operation Variable 

MACHID addr 

addr Address to receive machine identification, 

The following information is returned to location addr: 



addr 



id 



Machine identification. 



GETACT(051) 

The GETACT macro obtains information regarding outstanding system activity for your job. 
Macro format: t 

Location Operation Variable 
GETACT addr 
addr Address to receive information. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F) . 
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The following Information is returned to location addr: 

59 47 23 11 

addr 



sea 


« 


reserved 


reserved for 
installation 


reserved 



sea Count of system completable activities. 
8 Long-term activity pending. 

The sea field is incremented by one for each of the following: 

• PP activity outstanding. This includes any PP routines called without auto recall 
that have not yet completed (for example, CIO). The following PPs are not included: 

The PP that is processing the GETACT request. 

PPs that have moved away from your job's control point at the time the 
GETACT request is being processed and then move back to your job's control 
point. 

For jobs running under DIS control, the PP in which DIS is executing. 

• Tape I/O activity outstanding or PP routine(s) in recall. Although the tape 
activity is initiated through CIO requests, it is handled separately by the system 
and is counted here, not with the PP activity. 

• The rollout flag is set for your job. 

• An interactive I/O request that has been made but not yet processed. 

• Any SCP wait response indicators are set. 

If 2 (bit 47) is equal to 1, a long-term activity is pending. Such an activity requires 
either termination by the user or operator intervention. The following are long-term 
activities. 

• K or L console display interface. 

• CFO flag set (refer to Volume 3, System Commands, for a description of CFO entries). 

• A system control point (SCP) long-term connection. 

• DIS. 
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SETMFL (052) 

The SETMFL macro enables you to change the job step maximum field length (MFL) boundary 

/ £ «.- ni?rT1T7T r* 3 P17TT10T „_ — ~ _ £»«■ J -S **-... nn -! ~« « £ «h rt-.r •? *•.■«« £•! *> U 1 nnn 4-K 1 i«i f ^ 

parameter is 0, the maximum field length is set to your maximum allowable field length. 



Macro format : t 



Location 



Operation 



Variable 



SETMFL 



n,m 



New maximum central memory field length limit for job step. 
New maximum extended memory FL/lOOOg limit for job step. 



GETPFP (057) 

The GETFFP macro returns a job's permanent file parameters (current family name, pack name, 
device type, user name, and user index). 

Mac ro format : t 



Location Operation Variable 



GETPFP 



addr 



addr Address to receive three-word table containing permanent file parameters. 

The following information is returned to location addr: 





59 




17 







addr +0 




family name 









+ 1 


pack none 


device type 


+ 2 


user name 


user index 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix F) . 
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GETLOF(061) 

The GETLOF macro returns the list of files pointer for your job to the specified address, 
The list of files pointer is set with the SETLOF macro. 

Macro format : t 



Location Operation 



GETLOF 



Variable 



addr 



addr Address to receive the list of files pointer. 

The following information is returned to location addr: 



59 



addr 



47 



29 



pointer 



pointer Address of list of files table established with the SETLOF macro, 

c Completion bit. 

If the system returns in the pointer field, no list of files address has been previously 
set (refer to description of SETLOF macro) . 

SETLOF (062) 

The SETLOF macro enables the user program to specify a pointer to a list of files whose 
circular buffers will be flushed at job step abort or, for terminal files, when the job is 
rolled out or when the user program issues a read with recall request on INPUT. 

Macro format : t 



Location Operation 



SETLOF 



Variable 



addr 



addr Address containing the pointer to the list of files table. 

The following information must be specified at location addr: 

59 47 29 

addr 






pointer 


c 





poin fer 



Address of list of files table. 
Completion bit. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 



6-28 



60459690 B 



The list of files table has the following format. 



pointer +0 

+ 1 
+ 2 

+ len-2 
+ len-1 



59 






7 







u 







I en 


Ifn. 


fet 1 


lfn 2 


fet 2 




: 


lfn n 


fe *n 






len 



lfn. 



fet. 



Common memory manager (CMM) block indicator; setting this bit indicates 
that the file list is CMM controlled. 

Length of the list of files table including zero termination word. 

File name. 

FET address. 



The length of the list of files list must not exceed 7777g words. 

When used with an interactive job step, the first file in the list must be the terminal 
output file. 

During job step completion and after an error condition has occurred, the system uses the 
list of files to determine which files to complete for the user program. If the file name 
is OUTPUT or the FET has the flush bit set and the flushing criteria are met (refer to the 
description of the flush bit, FET Description in section 2), the data in the circular buffer 
is written to the specified file. 



GETJCI (074) 

The GETJCI macro returns job control information to the specified address. 



Macro format: t 



Location Operation Variable 



GETJCI 



addr 



addr 



Address of table to receive job control information. 



t This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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The following information is returned to the two words beginning at location addr. 
59 53 35 23 17 11 5 



addr +0 

+ 1 



efg 


RIG 


ccl 


em 


ssw 





ef 


R3 


R2 


R1 



efg 

RIG 
ccl 

em 

ssw 

ef 

R3 

R2 

Rl 



Global error flag (refer to Volume 3, System Commands, for a description 
of global error flag) . 

Global register. 

Reserved for system use. 

Exit mode (as described in appendix E). 

Sense switches (as described for ONSW macro). 

The last error flag encountered (as described for EREXIT macro) . 

Job control register 3. 

Job control register 2. 

Job control register 1 . 



SETJCI (074) 

The SETJCI macro sets job control information with values obtained from a two-word table. 



Macro format: t 



Location 



Operation 
SETJCI 



Variable 



addr 



addr 



Address of table specifying job control information. 



The job control information must be established in the same format as that described for the 
GETJCI macro. The exit mode field is ignored for all jobs and the ccl field is ignored for 
user jobs. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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PROTECT (075) 

The PROTECT macro enables the user program to select or deselect the following job control 
features , 

• Extended memory field length preservation over job steps. 



Macro f ormat : t 



Location 



Operation 



Variable 



PROTECT 



em, ufp 



ufp 



ON to select extended memory preservation; OFF to deselect extended 
memory preservation. 

ON to select user file privacy; OFF to deselect user file privacy. 



To specify extended memory field length preservation, you must be authorized to use the 
PROTECT command (refer to LIMITS command in Volume 3, System Commands). 

If the user program issues the PROTECT macro with the ufp parameter set to ON, all files 
that are subsequently created or accessed in the current job step are returned at job step 
termination. If a PROTECT macro with the ufp parameter set to OFF is subsequently issued in 
the same job step, only those files created or accessed prior to the second PROTECT macro 
are returned. 

If the user program selects user file privacy, a checkpoint of the job step in which the 
PROTECT function is issued is not allowed. 



SET JOB (106) 

The SETJOB macro allows the user program to specify or to change the user job name (UJN) , 
the disposition code for end-of-job output, and the end-of-job option. The user program 
must create a two-word parameter block containing this information before issuing the SETJOB 
call. 

Macro format : * 



Location 



Operation 



SETJOB 



Variable 



addr 



addr 



Address of parameter block. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F) . 
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Parameter block format: 





59 


23 


17 


11 





addr +0 


ujn 





+1 





op 


dc 





ujn 



op 



dc 



One- to seven-character alphanumeric UJN for the current job (left- 
justified, zero-filled). If binary zero, the current UJN remains in 
effect. The system initially assigns each job a UJN equal to the 
four-character user index hash or, for batch jobs, the name specified by 
the Job command. 

End-of-job option. 

op Description 



SU 
TJ 



Suspend job. 
Terminate job. 



Disposition of output at end of job. 



DF 

NO 
TO 



Description 

Default queue for job; depends on job origin type (refer 
to appendix E) . 
No output . 
Wait queue . 



If a field is set to binary zero, the corresponding option is not changed. 



GETSSID(llO) 

The GETSSID macro returns the subsystem identifier to the specified address ■ 
Macro format :t 

Location Operation Variable 



GETSSID 



addr 



addr Address to which subsystem identifier is returned. 
The following information is returned to location addr: 



11 



addr 



ssid 



ssid 



Subsystem identifier. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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GETJOSC (111) 

The GETJOSC macro returns the job origin and service class values to the specified address. 
Macro format :t 



Location Operation Variable 
GETJOSC addr 



addr 



Address to which job origin and service class values are returned. Refer 
to appendix E for a list of job origin and service class values. 



The following information is returned to location addr: 

59 11 



jo 



jo 



Service class. 
Job origin. 



SHELL (113) 

The SHELL macro allows you to specify controls for a shell program (refer to Volume 3 
System Commands, for a description of shell programs). 



Macro format: 
Location 

addr 



,t 



Operation 



Variable 



SHELL addr 

Address containing control information for shell program. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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The control information at address addr must have the following format. 



59 



addr 



17 



Ctrl 



name 
Ctrl 



Example: 



One- to seven-character name of shell program. 
Control information for shell program. 



Bit 

7 



Description 

Clear control information if there are SHELL load errors. 
(If this bit is not set, the job is terminated on a SHELL 
load error.) 

Clear control information if shell program aborts. This bit 
must be set if a project epilogue is defined for the current 
account block. 

Allow load of shell program from local file.t 

Allow load of shell program from global library. 

Allow load of shell program from system library. 

Call shell program during interactive job when there are no 
more commands to process . 

Call shell program for each command outside a procedure. 

Call shell program for each command inside a procedure. 



To allow shell program ABC to be loaded from a global library and to monitor all commands, a 
user program could include the following statements. 



SHELL CTRL1 



CTRL SET 1S4+1S2+1S1+1S0 
CTRL1 VFD 42/3LABC,11/0,7/CTRL 



Appendix L contains an illustration of a shell program that permits the use of non-NOS syntax 
commands . 



tA shell program loaded from a local file must be in ABS or OVL format. You must ensure 
that there is sufficient field length to load the program. 
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GETJAL (116) 

The GETJAL macro returns your job's current security access level and the job's security 
arrPRs level limits to the specified address. 



Macro format:* 



Location Operation Variable 
GETJAL addr 



addr Address to which the job's security access level information is to be 
returned . 



The following information is returned to location addr: 

59 17 11 

addr 






II 


ul 


al 



11 

ul 
al 



The numerical value of the job's lower access level limit. 
The numerical value of the job's upper access level limit. 
The numerical value of the job's current access level. 



The system OPL common deck COMCVLC can be used to convert access level names to numerical 
values and vice versa. 

On an unsecured system, GETJAL returns a zero word to location addr. 



SETJAL(117) 

The SETJAL macro changes the security access level of your job. This macro is valid only on 
a secured system. 



Macro format: 



Location 



Operation 



SETJAL 



variaDie 



addr 



addr 



Address of a word containing the numerical value of the new access level 
for the job, right- justified with binary zero fill. The access level 
specified must be valid for your job (refer to Security Access Levels in 
section 1). The access level specified may not be lower than the current 
job access level unless you have special authorization. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC. 
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GETUSC(123) 

The GETUSC macro returns the service classes valid for the user program for a particular job 
origin type and indicates the upper and lower priority bounds for each of those service 
classes. The user program must contain a parameter block consisting of one word of parameters 
for the request and one word for each service class to be returned. 

Macro format :t 



Location Operation 



GETUSC 



Variable 



addr 



addr Address of parameter block. 
Parameter block format: 





59 




47 




36 35 




23 




11 





addr+O 





ot 


len 


status 


addr+1 




sc 









in 


ex 


out 


«. 


*l 


















addr+n 


sc 





in 


ex 


out 



The user program enters the following information into the parameter block: 
Field Location Description 



ot 



len 



35-24 



23-12 



The job origin type for which service class information is to be 
returned. 

The maximum number of service classes for which information is to be 
returned. The symbol MXJC, defined in common deck COMSSCD, can be 
used to specify the number of service classes in the system. Service 
classes are returned in increasing numerical order (refer to appendix 
E for a list of valid service classes and the numerical value 
associated with each class). 

Completion bit (must be set to zero). 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F) . 
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The user program must enter zeros in the remainder of word addr+0. 
The following information is returned to the parameter block: 



Field 


Location 


Description 


len 


23-12 


The actual number of service classes returned. 


status 


11-1 


Error status. 

Value Description 



No error. 

1 Value of zero specified for len. 

2 Undefined origin type. 

3 Completion bit set in request. 

c Completion bit (set when processing is complete). 

sc 59-48 Two-character display code mnemonic for the service class. 

in 35-24 Lower bound for input files in this service class . 

ex 23-12 Priority upper bound; the highest possible priority for executing 

jobs in this service class. 

out 11-0 Priority lower bound; the lowest possible priority for output files 

in this service class . 

In the following example, the GETUSC macro is used to return information for all service 
classes for interactive origin type. 



OPL XTEXT COMCMAC REQUIRED FOR GETUSC MACRO 

OR. XTEXT COMSSCD ' DEFINES NXJC 

REPLY VFD 24/0,12/IA0T,12/MXJC,12/0 

BSSZ NXJC 



GETUSC REPLY 
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SETSC(124) 

The SETSC macro changes the service class of your job. 
Macro format:* 

Location Operation Variable 



SETSC addr 

addr Address of parameter word. 
Parameter word format: 

59 11 



addr 



SS 



The user program enters the following information into the parameter word: 

sc Mnemonic or numerical value for the service class to which the job is to 
be assigned (refer to appendix E for a list of valid service classes and 
the mnemonic and numerical value associated with each class); you must 
use the system OPL common deck COMSSCD in order to specify a service 
class mnemonic. 

CPM returns the following information to the parameter word: 

err Error status. 

Value Description 

No error. 

1 Undefined service class . 

2 Service class not valid for user and job origin. 

3 Service class full. 

In the following example, the job's service class is changed to batch service class (BCSC). 



OPL XTEXT COMSSCD 

OPL XTEXT COMCHAC 

PA RAM VFD 54/0,6/BCSC 



SETSC PA RAM 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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GETPAGE (127) 

The GETPAGE macro returns page size parameters to the specified address . 
Macro format:* 



IiOcaf on uDfi 



eracion 



GETPAGE 



variaDie 



addr 



addr Address to which page size parameters are returned. 
The following information is returned to location addr: 

addr 



59 




31 


27 


19 


11 




10 


reserved for CDC 


id 


jl 


jw 


res 


c 


reserved for CDC 


sd 


si 


sw 


res 



jl 

jw 

c 

sd 

si 



SETPAGE (130) 



Job print density in lines per inch (6 or 8). 

Job page length in lines. 

Job page width in characters. 

Complete bit. 

System print density in lines per inch. 

System page length in lines. 

System page width in characters. 



The SETPAGE macro allows the user program to specify page size parameters to control printed 
output . 



Macro format :t 

Location Operation Variable 



SETPAGE 



addr 



addr 



59 



addr 



Address of the word containing page size parameters. All parameters must 
be specified with unused fields set to binary zero. 



31 27 



19 



11 



id 



jw 



10 

3 



jd 
jl 

jw 
c 



Job print density in lines per inch (6 or 8). 
Job page length in lines ( 16 < jl < 255). 
Job page width in characters (40 < jw j< 255). 
Completion bit (must be zero on entry). 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC. 
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GETLVL(133) 

The GETLVL macro returns the PSR level of NOS that you are running. 
Macro format :t 



Location 



Operation 
GETLVL 



Variable 



addr 



addr Address of the word to which the system level is to be returned. The 
system level is a binary number, right-justified with binary zero fill. 



GETRI (134) 

The GETRI macro returns information on your job's current reprieve status to the specified 
address . 



Macro format: 

Location Operation Variable 
GETRI addr 

addr Address to which the reprieve information is to be returned. 
The following information is returned to location addr: 



59 54 53 



36 35 



24 23 



18 17 



addr flags 



mask 



eaddr 



flags 



mask 



eaddr 



If bit 59 is set, EREXIT processing is enabled. 

If bit 58 is set, normal reprieve processing is enabled. 

If bit 57 is set, extended reprieve processing is enabled. 

If bit 56 is set, normal reprieve is in progress. 

If bit 55 is set, extended reprieve is in progress. 

Normal reprieve mask bits (if normal reprieve condition is set). Zero 
(otherwise). 

Extended reprieve parameter block address (if extended reprieve 
processing is enabled). 

Error exit return address (if normal reprieve processing is enabled or if 
EREXIT processing is enabled). Zero (otherwise). 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix F) . 



6-40 



60459690 D 



GETCN (136) 

The GETCN macro returns the charge and project number. 

The GETCN macro returns a four-word block containing the current charge and project number 
combination beginning at the specified address. Word four, bit 59, will be clear if this is 
a nonvalidated charge and project number. Word four, bit 59, will be set if these are 
validated numbers . (The only case in which the numbers would not have been validated is if 
your validation did not require you to have a valid charge and project number and your job 
had never issued an explicit CHARGE command.) 



Macro format: 



Location 



Operation 
GETCN 



Variable 



addr 



addr Address of the reply block. 
The following information is returned to the four-word reply block beginning at location addr: 
59 



addr+O 
addr+1 
addr+2 
addr+3 



charge number 



project number (first 10 characters) 



project number (second 10 characters) 



Validation bit. 
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CSTATUS (137) 

The CSTATUS macro returns the type of the system console. 

Macro format :t 

Location Operation Variable 
CSTATUS addr 

addr Address of the word to which the console type is to be returned. 



59 4847 



addr 



type 







type Console type of primary console: 

= CC545 

1 = CDC 721 



tThis macro is not available in SYSTEXT. The user program must specify system text PSSTEXT 
or call common deck COMCDCM. 
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FILE ROUTING 



IN£Q Bl lkl^TI/\kl 

The dispose processor (DSP) perforins file routing operations for NOS. DSP places a file in 
the specified queue at either the central site or a remote batch site. A user program can 
call DSP by issuing an RA+1 request or a ROUTE. macro. A DSP call can be made from a job of 
any job origin type. 



NOTE 



If a file is routed to an input queue, it 
must contain a valid USER command or the job 
step initiating the route will be aborted 
with a security conflict. Refer to section 
1 of this manual for more information on 
security conflict processing. 



The format of the call to DSP is: 



59 



40 35 



17 



RA + 1 



DSP 


m 





oddr 



R Auto recall bit. 

addr First word address of parameter block. 
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The user program must define a parameter block containing the following information before 
issuing a DSP RA+1 call or a ROUTE macro. 



NOTE 



Various symbols related to DSP calls and the 
DSP parameter block are defined in the 
system OPL common deck COMSDSP. 





59 


47 


41 


35 


23 






17 


11 


addr+O 




Ifn 


ec 


reserved c 


+1 


reserved 


forms 


disp 


ex 


i 


ie 


flags 


+2 


slid 






dlid 


tid 


+3 


ujn 


reserved 


priority 


-1-4 


spacing 


service class 


abort code 


reserved 


re 


reserved 


+ 5 


reserved 


+6 


reserved 



ay setLin 8 Dit o or the flags field in addr-i-1, the user program can define an extended DSP 
parameter block containing the following information. 





59 




47 




23 


17 







addr +7 


dd 


reserved for CDC 





eflags 


+10 


reserved for CDC 


reserved for CDC 


+11 


reserved for CDC 


ertaddr 


+12 


reserved for CDC 




+13 








reserved for CDC 








+14 


reserved for CDC 


+15 


reserved for CDC 


+16 


reserved for installations 



NOTE 



In general, a field in the DSP parameter 
block (or extended block) will only be 
processed if the corresponding bit in the 
flags (or eflags) field is set. 



Ifn 



Local file name of file to be routed (must be a queued file or a local 
file; must not reside on a removable device; and must not be an 
execute-only file). After the request has been completed, this contains 
the JSN of the queued file (if bit 17 of flags was set). 

Error code returned by system when bit 12 of flags field is set (error 
codes described later in this section). 

Completion bit (must be zero when function is issued; system sets bit to 
one when operation complete). 
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forms Forms code or input flags. Two display code characters or specific bits 
set identifying the forms to be used for this file or other processing 
options. If file is routed to input queue, this field is defined as 

F„1 1 „™, . 

Bit(s) Description 

47-45 Reserved. 



44 
43 



Send file to output queue with forced abort error code. 
Send file to input queue even if Job command error 
occurs . 
42-36 Reserved. 



Forms codes consist of two alphanumeric characters and are assigned by 
each installation. You should contact installation personnel to 
determine what forms codes are available (if any). 

disp Disposition code . Two alphanumeric characters specifying the 
disposition of the routed file. 

Code Description 

INt Release file to input queue. 

LP Print on any line printer. 

LR Print on 580-12 line printer. 

LS Print on 580-16 line printer. 

LT Print on 580-20 line printer. 

NO Release file to input queue. Drop job output files at job 

completion. 

PB Punch system binary. 

PH Punch coded. 

PL Plotter. 

PR Same as LP. 

PU Same as PH. 

P8 Punch 80 column binary. 

SB Same as PB. 

SC Rescind prior routing and change file type to local (LOFT) . 

TO Input queue, output to wait queue. 

TT Wait . 

WT Same as TT. 

ex External characteristics of print files: 

ex Description 

Any external characteristics. 

1 Not used . 

2 ASCII graphic 48-character set (not supported; provided for 
NOS/BE compatibility) . 

3 CDC graphic 48-character set (not supported; provided for 
NOS/BE compatibility). 

4 CDC graphic 63/64-character set. 

5 ASCII graphic 63/64-character set. 

6 ASCII graphic 95-character set. 

7 Reserved . 



tWhen a job that has been routed to IN runs to completion, the following local files (if 
they exist) will be routed to the appropriate queues: 0UTPUT,PUNCH,PUNCHB,P8. You can 
prevent this implicit file routing with the SETJOB command or macro. 

60459690 B 7-3 



External characteristics of punch files: 



ex 


Description 





System default . 


1 


System binary. 


2 


80-column binary 


3 


Not used. 


4 


026 mode. 


5 


029 mode. 


6 


ASCII . 


7 


Reserved . 



External characteristics of plot files: 
ex Description 

Reserved . 

1 Transparent 6-bit plotter data. 

2 Transparent 8-bit plotter data. 
3-6 Not used. 

7 Reserved . 



ic 



Forced service class flag. Ir set, the specitied service class will be 
used. 

Internal characteristics (bits 19 through 18) code: 

Value Description 



Display code. 
ASCII code. 
Binary . 
Reserved . 



If ic is not specified, the system assigns a default value based on the 
value of ex. 



ex for 


Print 


Files 


Default ic 




2 




1 




3 









4 









5 









6 




1 


ex for 


Punch 


Files 


Default ic 




1 




2 




2 




2 




4 









5 









6 




1 
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flags Each bit set indicates that a particular parameter is specified. 

Bit Description 

17 Job sequence name assigned to queued file by system is 

returned to addr+0, bits 59 through 18. 

16 Reserved. 

15 580 PFC spacing code. 

14 Repeat count . 

13 UJN is specified in addr+3, bits 59 through 18. 

12 No dayfile message and return error code to addr+0. bits 

17 through 12. 

11 Reserved. 

10 Forms code. 

9 Priority. 

8 Internal characteristics. 

7 External characteristics. 

6 Extended parameter block. 

5 Reserved for installations. 

4 Disposition code. 

3 SLID/DLID. 

2 TID. 

1 Route to central site. 

End-of-job (deferred ROUTE). 

The system determines the routing destination of an output file by flag 
bits 1 and 2 (route to central site and tid, respectively) as follows: 

Central tid 

Site Bit Bit Routing Activity 

If the calling job is of remote batch origin, 

the system routes output to the remote batch 
queue and associates with it the user name and 
family of the originating remote batch 
terminal. If the calling job is any other 
origin type, the system routes output to the 
central site queue. If the file being routed 
was previously routed with queuing deferred, 
the previously specified destination remains in 
e f f ec t . 

slid Three-character alphanumeric logical identifier (LID) of the source 

mainframe for the file. The following special values may also be 
entered in this field. 

Value (Octal) Description 

Get slid from job input file system sector. 

1 Set si id to zero . 

2 Set slid to physical identifier of this mainframe. 
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dlid Three-character alphanumeric logical identifier (LID) of the destination 
mainframe for the file. The following special values may also be 
entered in this field. 

Value (Octal) Description 

Set dlid to zero. 

1 Set dlid to zero. 

2 Set dlid to physical identifier of this mainframe. 

tid For routing to a remote batch queue, this field should contain the 

complement of the address of a two-word block. The first word of the 
block contains the family name and the second word contains the user 
name (both left-justified and zero-filled). This is the user name that 
must be used to log in at a remote terminal to get the routed file. 

If the address specified by the tid field equals 77777777 8 , the file 

is routed to the remote batch queue with the family and user name of the 

calling job. 

For routing to the local batch queue, the tid contains an ID code (right- 
justified). 

u J n The user job name (UJN) to be used instead of the job's default UJN. 

Routing Activity 

The system routes output according to the 
contents of the tid field (description follows). 
The system routes output to the central site 
queue • 

The system routes output to the central site 
queue if the tid field contains a valid ID 
code; otherwise, the system aborts the job. 

priority If job priority is greater than 7760 octal, the specified priority is 
used for output files (otherwise field is ignored). 

spacing Spacing code for output files (580 PFC) . Octal value from to 77. 

service Two-character forced service class code in display code, specifying the 
class service class of the routed file. Refer to appendix E for a list of 
valid service classes and service class codes. 

abort code If bit 44 of the DSP parameter word 1 is set, the value of this field 

determines which message from the following table is sent to the dayfile. 

Value Message 



Central 


tid 


Site Bit 


Bit 





1 


1 





1 


1 



0001 


Job command error . 


0002 


Card reader error. 


0003 


Operator input termination. 


0004 


Disk full. 


0005 


Disk parity error. 
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dd 



Repeat count. 

The data declaration in display code; defines the data type of a file 
destined to a remote mainframe. 



eflags 



ertaddr 



dd Data Type 

C6 6-bit character data. 

C8 8-bit character data. 

US Undefined data type, structured file. 

UU Undefined data type, unstructured file. 

Flags indicating which parameters are specified in the extended 
parameter block. 



Bit 

17-1 




Description 



Reserved. 

Data declaration. 



The first word address of the block containing the explicit remote text 
string for the file. The first word of the block contains the length of 
the string in characters; the rest of the block contains up to 300g 
display-code characters. 



ROUTE 

The format of the ROUTE macro is as follows: 



Location 



Operation 



ROUTE 



Variable 



addr,R 



addr Address of parameter block. 
R Auto recall bit. 



Example 1 : 



The following example routes a file named PRINTF for printing on any central site line 
printer. 



PBLK 



VFD 


42/0LPRINTF,18/0 


VFD 


24/0,1 2/2HLP,6/0,18/22B 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 



ROUTE PBLK,R 
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Example 2: 



The following example performs a deferred route of a file named PRINTF In ASCII graphic 
95-character set and specifies that two copies be printed. 



PBLK 



VFD 


42/0LPRINTF,18/0 


VFD 


24/0,1 2/2HLP,3/6,3/0,1 8/40221 B 


VFD 


60/0 


VFD 


60/0 


VFD 


42/0,6/1,12/ 


VFD 


60/0 


VFD 


60/0 



ROUTE PBLK,R 



Example 3: 



The following example routes a file named J0B1 to the input queue for processing at the 
central site and writes the job name assigned by the system to the user dayfile. 



PBLK 



VFD 


42/0LJ0B1,18/0 


VFD 


12/0,1 2/1 000B,12/2HIN,6/0,18/402022B 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


VFD 


60/0 


ROUTE 


PBLK,R 


SA1 


PBLK 


MX0 


42 


BX6 


X0*X1 


SA6 


A1 


MESSAGE 


PBLK,3 
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ERROR PROCESSING 



When an error occurs in processing a ROUTE macro or DSP call, either a dayfile message 

3 trtfvs\-r* -to -f £*cmi£w1 s\v an ar-mr r*rv\a -i a vat- wrr\aA -It 



addr+0. If the address of the parameter block is outside the field length of the job or if 
the completion bit is set when the function is issued, the job step aborts. For all other 
errors, the function is not executed, but error processing continues. If bit 12 of the 
flags field is set, an error code j.s returneu anu no uayi.ij.e message is issued. If bit 12 
is not set, no error code is returned, a dayfile message is issued, and the job step aborts. 

The error codes that can be returned are as follows: 



Error Codes 



Description 



1 
2 
3 
4 
5 
6 
7 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
45 



File name error. 

File not on mass storage. 

Invalid file type. 

Reserved . 

Route to input not immediate. 

Immediate routing, no file. 

Incorrect disposition code. 

User access not valid. 

Undefined service class. 

Incorrect request (unconditional abort). 

Deferred routing not allowed. 

Incorrect data declaration. 

Incorrect LID. 

Cannot route job input file. 

Completion bit already set (unconditional abort) 

File on removable device. 

Incorrect TID. 

Forms code not alphanumeric. 

Incorrect internal characteristics. 

Queued file read error. 

QFT full. 

This routing not allowed. 

Device full. 

Mass storage error. 

I/O sequence error (unconditional abort). 

Job command error . 

Too many deferred batch jobs. 

Incorrect USER command . 

Dev ice unav ail able . 

Incorrect file mode. 

Incorrect external characteristics. 

Incorrect origin type. 

Incorrect spacing code. 

Incorrect job abort code. 

Incorrect owner user and family name . 

Incorrect creation user and family name. 

Service class incorrect for user or job origin. 



For a complete listing of error messages, refer to appendix B. 
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QUEUE ACCESS INTERFACE 



The queue access (QAC) interface allows a user program to Interact with the executing job 
table (EJT) and the queued file table (QFT). The user program can specify either a single 
entry (file or job) in a QAC request, or a group of entries. Requests are provided that 
allow a user program to: 

• Attach files that are in the QFT (GET request). 

• Determine the status of files in the QFT and jobs in the EJT (PEEK request). 

• Alter or purge files in the QFT and jobs in the EJT (ALTER request). 

A user program accesses the QAC interface by issuing an RA+1 call. The format of the call 
is: 



59 




40 


17 







RA + 1 | 


QAC 


W///////////////M 


addr 



R Auto recall bit. 

addr Address of the QAC parameter block; must be a valid address within your 
job's field length. 

The user program must define a parameter block before issuing the RA+1 call. The first 
1^8 words of this block are common to all requests. 



NOTE 



addr + 
+ 1 
+ 2 
+ 3 
+ 4 
+ 5 
+ 6 
+ 7 
+ 10 
+ 11 
+ 12 
+ 13 



Various symbols related to QAC calls and the 
QAC parameter block are defined in system 
OPL common deck COMSQAC. 



59 






47 


41 


35 


26 


23 20 


17 11 


9 


Ifn 


err 


fen c 


W//////////////////////M 


len 


first 





in 





out 


f nt ord 


ejt/qft ord 


queue 


V///A 


limit 


dest family 


id 


origin 


dest un 


dest ui 


jsn 


se lectio 


n flags 




queue sel 


forms 


disp 


ec 


ic 


link addr 


slid 


dlid 


al 
lt> 


al 
ub 


alid addr 


li 


ui 


reserved for Control Data 


reserved for installation use 
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Field Description 

lfn The user program sets this field for a GET request to the local file 

name to be given to the queued file when it is attached from the queue. 
If this field is set to zero, QAC assigns the job sequence name (JSN) of 
the file as the local file name. 

err QAC enters one of the following error codes upon completion of a 

request. Error codes 1 through 12g indicate nonfatal errors. During 
linked request processing, QAC continues with the next request when a 
nonfatal error is detected. 

err Description 

The request completed without error. 

1 Incorrect queue type. Indicates one of the following 
conditions . 

• Undefined queue bits (addr+lOg) were set. 

• For a GET request, the executing job queue was 
selected. 

• Bit 0, addr+7 is set, but more than one queue was 
selected in addr+4. 

• The user program entered an invalid queue type in 
the queue field of addr+4 during an interrupted 
PEEK request. 

2 Incorrect family/user name. The specified family (addr+5) 
or user name (addr+6) is not active or failed validation. 

3 Undefined origin type (addr+5). The specified origin type 
is not valid. 

4 The user program sets one of the following combinations of 
bits. 

Bits 3 and 4 of the selection flags field (addr+7). 

Bits 9 and 10 of the selection flags field (addr+7). 

Bits and 1 of the alter flags field (addr+14g). 

Bits 10 and 11 of the alter flags field (addr+14 8 ). 

Bits 12 and 16 of the alter flags field (addr+14g). 

Bits 9, 13, 14, and 15 of the alter flags field 
(addr+14g). 

Incorrect forms code. The forms code field (addr+17g) for 
an ALTER request does not consist of two alphanumeric 
characters or a zero. 
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Field Description 

err Description 

6 Incorrect disposition code (addr+lOg, or addr+17g for an 
ALTER request), or the PO disposition code was selected but 
no external characteristics were specified to select a 
particular punch type. 

7 File or job not found. 

10g Duplicate local file name. For a GET request, QAC refused 
to attach a file because the file has the same name as an 
existing local file. QAC enters the name of the file that 
caused the error in the lfn field (addr+O). This condition 
does not result in an error if the inhibit duplicate lfn 
search flag (bit 1, addr+7) is set. 

118 Incorrect batch ID. The batch ID specified (addr+5, or 
addr+16g for an ALTER request) is not less than 70s. 

12g Incorrect file name. The local file name (addr+O) specified 
for a GET request is not valid. 

13g Count of zero incorrect. The maximum number of files or 
jobs to be selected in a PEEK request (addr+14g and 
addr+15g) for at least one queue must be greater than 
zero. 

14g The user program did not set any alter flags (addr+14g) 

for an ALTER request, or the QAC buffer is not large enough 
to hold one PEEK reply for a PEEK request. 



22g Incorrect external characteristics. The external 

request is 






not valid. 

23g The user program attempted to drop an interactive job. 

24g Incorrect destination LID. The destination LID (addr+15g) 
for an ALTER request is not valid. 

25g Incorrect access level. Either the access level selection 
limits (addr+llg) or the new access level for an ALTER 
request (addr+17g) are not valid. 

26g Incorrect file size index. The file size index selection 
limits (addr+12g) are not valid. 

27g Incorrect service class. The two-character service class 
was not valid for the user, or not valid for the current 
origin type of the specified job. 

30g Service class full. The service class change cannot be 

made because the number of jobs with that class is already 
at the service limit. 

31g Cannot change class of on-line job. The service class of 
another on-line job cannot be changed. 
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Field Description 

err Description 

32g Undefined service class. The service class mnemonic is not 
defined. 

33g Job already waiting on service class. The service class 
change cannot be made because the job is waiting for a 
CLASS command in the job to complete. 

34g Cannot change class of subsystem. The service class of a 

job that is executing at the subsystem service class cannot 
be altered. 

fen The user program enters the function code number for the type of request. 

Request fen 

ALTER 1 
GET 2 
PEEK 3 

c Completion bit. The user program must set this bit to zero. QAC sets 
this bit to one when the request Is complete. 

len The user program enters the total length of the QAC parameter block 
minus 5. The value of len for each type of request is as follows: 

Request len 



ALTER 




14 8 


Extended 


GET 


116 8 


GET 




138 


PEEK 




13 8 



first The user program enters the first word address of the buffer to be used 
by QAC . For an ALTER request , the user program can enter messages in 
the buffer; for a PEEK request, QAC enters the PEEK reply block in the 
buffer. 

in This field is a pointer to the next available word In the buffer to 

which information can be written. For a PEEK request, the user program 
must set this field to the same value as first. 

out This field is a pointer to the next word that can be read from the 

buffer. For a PEEK request, the user program must set this field to the 
same value as first. For an ALTER request involving a message, the user 
program enters the beginning address of the message. 

fnt ord QAC enters the FNT ordinal of a file when the file is attached from a 
queue . 
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Field 
ejt/qft 



queue 



limit 



Description 

The user program eaters the QFT ordinal of the file or the EJT ordinal 
, -*~ *-"*- jv -»-* X i>.w j.a fc.w (iiwtcoo uu.i.jr uiic nm or jod navmg cms 
ordinal. QAC enters the QFT ordinal of a file when the file is attached 
during a GET request. For an initial PEEK request, the user program 
must set this field to zero. QAC enters the QFT or EJT ordinal of the 
file or job currently being examined if a PEEK request is interrupted 
because the QAC buffer is full. QAC enters a value of zero when the 
request is complete. 

QAC enters a value indicating the queue in which a file was found for a 
GET request, or the remaining queues to be examined for a PEEK request. 
The user program must set this field to zero for an initial PEEK request 
and must not alter its contents when issuing continuation calls. QAC 
enters a value of zero upon successful completion of a PEEK request. 

Bit(s) Queue 

Input queue . 

1 Executing job queue. 

2 Print queue. 

3 Punch queue. 

4 Plot queue. 

5 Wait queue. 

6-7 Reserved for Control Data. 

8 Reserved for installations. 
9-11 Reserved for Control Data. 



The user program enters 
used by QAC. 



the limit address (LWA+1) of the buffer to be 



dest 
family 



id 



The user program enters the destination family name if QAC is to consider 
only one family (the program must also set bit 3, addr+7). This 
represents the family under which you would have to log in to access the 
file or job at a remote batch terminal. A value of zero selects the 
default family name. QAC enters the destination family name of the file 
that is attached during a GET request. 

The user program enters an ID code if QAC is to consider only one ID code 
(the user program must also set bit 4, addr+7). QAC enters the ID code 
of the file attached during a GET request. 
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Field Description 

origin The user program enters a value if QAC is to examine files or jobs of 
only one origin type (the program must also set bit 5, addr+7; if this 
bit is not set, QAC examines files and/or jobs of all types). On a GET 
request, the origin type of the attached file is returned in this field. 

Origin Origin type 



00 


Caller's origin. 


01 


SY0T (system). 


02 


BCOT (local batch). 


03 


RBOT (remote batch). 


04 


IAOT (interactive). 


05-77 


Reserved. 



dest The user program enters the destination user name if QAC is 
un to consider files and/or jobs for only one destination user name (the 
program must also set bit 3, addr+7). This represents the user name 
under which you would have to log in to access the file or job at a 
remote batch terminal. QAC enters the user name of the file that is 
attached during a GET request. 

dest QAC enters the destination user index of the file that is 

ui attached during a GET request. This represents the user index under 

which you would have to log in to access the file or job at a remote 

batch terminal. 

jsn The user program enters the job sequence name (JSN) if QAC is to 

consider files and/or jobs for only one JSN (the user program must also 
set bit 6, addr+7). QAC enters the JSN of the file that is attached 
during a GET request. 

selection The user program sets the appropriate bits in this field to 
flags limit QAC's search of jobs or files to specific types. Where noted, 
these bits are used in conjunction with other fields in the parameter 
block to specify the type of job or file QAC is to search for. 

Bit(s) Description 

Specific ordinal (addr+4) and specific queue (addr+lOg). 

1 Inhibit duplicate lfn search. If set, QAC will allow a 
file having the same name as a local file to be attached in 
a GET request. Otherwise, an attempt to attach such a file 
causes an error flag in addr+0 to be set and the request is 
terminated . 

2 Include priority=0 in selection. If set, QAC will select 
files and/or jobs that have a priority of zero, provided 
they meet other selection criteria. 

3 Destination family name (addr+5) or destination user name 
(addr+6). 

4 ID code (addr+5). 

5 Origin type (addr+5). 

6 JSN (addr+7). 

7 Forms code (addr+lOg). 

8 Disposition code (addr+lOg). 

9 Explicit external characteristics (addr+lOg). 

10 Hierarchical external characteristics (addr+lOg). 

11 Include ec=0 (any external characteristics) in selection 
hierarchy (addr+lOg), 
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field 



Description 



Bit(s) 

12 
13 

1 /. 

£ *» 

15 
16 

17 

18 

19 

20 
21-32 
33-35 



Description 

Internal characteristics (addr+lOg). 
Access level (addr+llg). 

n^«*-4««*-4 ~„ TTn / „ J j—4,1 1 „ \ 

List of alternate destination LIDs (addr+llg). 

Source LID (addr+llg). 

Include LP disposition code in addition to disposition code 

selected (print files only). 

Select only recoverable jobs (detached interactive jobs). 

Enabled destination LID. 

File size index range specified. 

Reserved for Control Data. 

Reserved for installations . 



queue 
sel 



Bits 3 and 4 may not both be set, and bits 9 and 10 may not both be set. 
Bit 11 can be set only if bit 9 or bit 10 is set. Bit 17 can be set 
only if bit 8 is set. 

The user program sets one or more bits in this field to indicate which 
queue or queues QAC is to consider. 



Bit(s) 



Queue 






Input queue. 


1 


Executing job queue. 


2 


Print queue. 


3 


Punch queue. 


4 


Plot queue . 


5 


Wait queue . 


6-7 


Reserved for Control Data. 


8 


Reserved for installations . 


9-11 


Reserved for Control Data. 



forms The user program enters a two-character alphanumeric forms code if QAC 

is to consider only files with a particular forms code (the program must 

also set bit 7, addr+7). QAC enters the forms code of the file that is 

attached during a GET request. 

disp The user program enters a two-character disposition code if QAC is to 

consider only files with a particular disposition code (the program must 

also set bit 8, addr+7). QAC enters the disposition code of the file 
that is attached during a GET request. 

disp Description 

IN Input queue. 

LP Print on any line printer. 

T.B Pi--tr>t *>»> ^S^- 1 2 lifSP tvrtriter- 

LS Print on 580-16 line printer. 

LT Print on 580-20 line printer. 

NO Input queue , no output . 

PL Plotter . 

PR Same as LP. 

PU Punch (specific punch type must be entered in the ec field), 

TO Input queue , output to wait queue . 

TT Wait queue. 

WT Same as TT. 
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Field Description 

ec The user program enters an external characteristics code if QAC is to 
consider only files with particular external characteristics (the 
program must also set bit 9, or 10, addr+7). QAC enters the external 
characteristics code of the file that is attached during a GET request. 

External characteristics of print files: 

ec Description 

Any external characteristics. 

1 Not used. 

2 ASCII graphic 48-character set (not supported; provided 
for NOS/BE compatibility). 

3 CDC graphic 48-character set (not supported; provided for 
NOS/BE compatibility). 

4 CDC graphic 63/ 64 -character set. 

5 ASCII graphic 63/64-character set. 

6 ASCII graphic 95-character set. 

7 Reserved. 

External characteristics of punch files: 



ec 


Description 





System default. 


1 


System binary. 


2 


80-column binary 


3 


Not used. 


4 


026 mode. 


5 


029 mode. 


6 


ASCII. 


7 


Reserved. 



External characteristics of plot files: 
ec Description 

Reserved. 

1 Transparent 6-bit plotter data. 

2 Transparent 8-bit plotter data. 
3-6 Not used. 

7 Reserved. 

If the user program sets bit 9 of addr+7 (explicit external 
characteristics), QAC searches only for files having the external 
characteristic selected. If the program sets bit 10 (hierarchical 
external characteristics), QAC searches for files having compatible 
external characteristics. The following codes cause QAC to search for 
files in the order listed. 



8-8 60459690 B 



Field 



Description 



Hierarchical external characteristics for print files: 



ic 



ec 



4 
5 
6 



Compatible Types 

ASCII graphic 95-character set, ASCII graphic 

63/64-character set, ASCII graphic 48-character set, CDC 

graphic 63/64-character set, CDC graphic 48-character set. 

CDC graphic 63/64-character set, CDC graphic 48-character 

set. 

ASCII graphic 63/64-character set, ASCII graphic 

48-character set. 

ASCII graphic 95-character set, ASCII graphic 

63/64-character set, ASCII graphic 48-character set. 



Hierarchical external characteristics for punch files: 
ec Compatible Types 



80-column binary, system binary. 
029, 026. 



The user program enters an internal characteristics code if QAC is to 
consider only files with particular internal characteristics (the 
program must also set bit 12, addr+7). QAC enters the internal 
characteristics code of the file that is attached during a GET request. 



ic 


1 
2 
3 



Description 

6-bit display code. 
12-bit ASCII. 
Binary. 
Reserved. 



link addr The user program enters either zero or, in order to process linked QAC 
requests, the address of the next QAC parameter block. Any nonzero 
value entered in this field must be a valid address within the user 
program's field length. Upon completion of the current request, QAC 
checks this field. If a nonzero value is present, QAC processes the 
request at address link addr. 

slid The user program enters the source logical identifier (LID) if QAC is to 
consider only files originating at a particular mainframe. If bit 16 of 
the selection flags field is set, a value of zero specifies only files 
without a source LID. QAC enters the source LID of the file that is 
attached during a GET request. 

dlid The user program enters the destination logical identifier (LID) if QAC 
is to consider only files with a particular destination LID. If bit 16 
of the selection flags field is set, a value of zero specifies only 
files without a destination LID; a value of *** (474747g) specifies 
all files regardless of LID. QAC enters the destination LID of the file 
that is attached during a GET request. 

al lb The user program enters the access level lower bound if QAC is to 

consider only files with an access level equal to or greater than a 
particular value (the program must also set bit 13, addr+7). 
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Field Description 

al ub The user program enters the access level upper bound if QAC is to 
consider only files with an access level equal to or less than a 
particular value (the program must also set bit 13, addr+7). 

alid addr The user program enters the address of a list of alternate destination 

LIDs if QAC is to consider only files from that list of destination LIDs , 
The list of alternate LIDs has the following format: 





59 




41 


23 


5 


alid addr +0 


dlid-| 


dlid 2 


dlid 3 


WA 


+ 1 


dlid 4 


dlid 5 


dlid 6 


W/,. 


■ v 




+n 


*d3n+1 


dlidan+2 


dlid 3n+3 


WA 



The list is terminated by the first 18-bit zero field starting at bit 
59, 41, or 23. 



me user program enters trie riie size index lower bound n 



QAC 



consider only files with a file size index within a specified range (the 
program must also set bit 20, addr+7). If li is specified, ui must also 
be specified, and li must be .LE. ui. 



QAC REQUESTS 



The user program enters the file size index upper bound if QAC is to 
consider only files with a file size index within a specified range (the 
program must also set bit 20, addr+7). If ui is specified, li must also 
be specified, and ui must be .LE. li. 



The following pages describe the three types of QAC requests: ALTER, GET, and PEEK. Each 
type of request uses a different format for the remainder of the parameter block following 
addr+13g. 
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ALTER REQUEST 

The ALTER request changes characteristics of queued files or executing jobs. The alter 
~^ags ^n a^^r+^-tg determine which characteristics the ALTER request is to change. QAC 
cannot alter the calling job. 

The format of the remainder of the parameter block for an ALTER request is as follows: 

59 53: 47 35 29 23 20 17 11 5 n 



ssw 



alter 
flags 



addr + 14 


ssw 


W/////////////W. 


alter flags 


+ 15 


new dest family 


new dest lid 


+ 16 


new dest un 


Wl 


sp cd 


ID 


+ 17 


reserved 


forms 


disp 


ec 


al 


src 


rep 


+ 20 


reserved for installations 


Field 










Description 









The user program enters bit values to which the sense switch settings of 
jobs are to be altered. Bits 54 through 59 correspond to sense switches 
1 through 6 respectively. If bit 10 of addr+14 8 (turn sense switches 
on) is set, the sense switches whose corresponding bits in this field 
are set to one are changed to one for the selected jobs. If bit 11 of 
addr+14 8 (turn sense switches off) is set, the sense switches whose 
corresponding bits in this field are set to zero are changed to zero for 
the selected jobs. Refer to the ONSW and OFFSW macro descriptions in 
section 6 for descriptions of the individual sense switches. 

The user sets the appropriate bits in this field to specify the 
information that QAC is to alter. 

Bit(s) Description 

Change remote family name, user name. 

1 Change local batch identifier. 

2 Reserved for Control Data. 

3 Alter forms code. 

4 Alter spacing code. 

5 Alter disposition code. 

6 Alter external characteristics. 

7 Alter repeat count. 

8 Alter access level. 

9 Abort job or evict file. 

10 Turn sense switches on. 

1 1 Turn sense switches off . 

12 Clear pause bit. 

13 Send comment to dayfile. 

14 Send comment from operator. 

15 Indicate message available for aborted job. 

16 Set pause bit. 

17 Alter destination logical identifier. 

18 Kill job. 

19 Alter service class. 
20-26 Reserved for Control Data. 
27-29 Reserved for installations. 
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Field 



Description 



Bit 15 can be set only if bit 9 is set. Only one of bits 13, 14, and 15 
can be set. If bit 13, 14, or 15 is set, the program must enter a 
message In the QAC buffer defined by the fields FIRST, IN, OUT, and 
LIMIT. 

new The user program enters the new destination family name for the files 
dest and/or jobs. The program must also set bit 0, addr+14g. QAC changes 
family the destination family and routes the files/ jobs to remote batch. The 

specified family must be known to the system but need not be active. If 
this field is selected and has a value of zero, QAC uses the family of 
the requesting job's control point. 

new The user program enters the new destination logical identifier (LID) for 
dest selected input and/or output files. The program must also set bit 16, 
lid addr+Hg. 

new The user program enters the new destination user name for the files 
dest and/or jobs. The program must also set bit 0, addr+14g. QAC changes 
un the destination user name and routes the files/jobs to remote batch. If 
this field is selected and has a value of zero, QAC uses the user number 
associated with the job in which the User program is executing. 

sp cd The user program enters the new spacing code for the files. This field 
affects only print files. The program must also set bit 4, addr+14g. 
Values of through 77g are accepted; if the value entered Is not 
defined for the installation, the released default value (0) is used. 
For more information on spacing codes, refer to the NOS 2 Analysis 
Handbook . 

id The user program enters the identifier for the local batch queue to 

which the files and/or jobs are to be routed. The program must also set 
bit 1, addr+14g. 

forms The user program enters the new forms code for the files . This field 
affects only output files. The program must also set bit 3, 
addr+14g. This field may contain any two alphanumeric characters or 
zero. 



disp 



al 



The user program enters the new disposition code for the files . This 
field affects only output files. The program must also set bit 5, 
addr+14g. Valid disposition codes are listed in the description of 
the disp field of addr+lOg. 

The user program enters the new external characteristics code for the 
files. This field affects only output files. The user program must also 
set bit 6, addr+14g. Valid external characteristics codes are listed 
in the description of the ec field of addr+lOg. A value of zero for a 
punch file selects the installation-defined default punch mode. 

The user program enters the new access level for the files. The program 
must also set bit 8, addr+14g. This field may contain any value from 
through 7. (You can convert a symbolic access level name to a 
numerical value, or vice versa, using system OPL common deck COMCVLC.) 
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Field Description 

src The user program enters the new service class for files in the input 
queue and for executing jobs. The program must also set bit 19, 
addr+14g. This field does not affect output files. The service class 
is specified as the first two characters in the display code of one of 
the service class mnemonics listed in appendix E. 

rep The user program enters the new repeat count for output files. The 

program must also set bit 7, addr+14 8 . The maximum value allowed is 37s. 



Example : 



The following program clears the pause bit in all executing jobs submitted under the 
same user name as the program (except the job in which the program is executing). The 
program also enters the message PROGRAM RESTART HAS CLEARED PAUSE BIT in the user 
dayfile of each job. This program uses the SYSTEM macro (refer to section 11) to issue 
the QAG request. 

IDENT RESTART 
ENTRY RESTART 



MSG 
TAG1 

** 
BLOCK 



RESTAR1 



MESSAGE BUFFER 



DATA 




C*PR0GRAM RESTART 


HAS CLEARED PAUSE BIT* 


ECU 




*-MSG 




QAC 


PARAMETER BLOCK 




BSS 









VFD 




59/1,1/0 


ALTER FUNCTION CODE 


VFD 




36/0,6/1 2,1 8/MSG 


MESSAGE BUFFER, FIRST 


VFD 




42/0,18/MSG+TAG1 


, IN 


VFD 




42/0,18/MSG 


, OUT 


VFD 




-»- 9 w/ i w/ nwo • i n O i ■ i 


» 1 TMTT 

t Linii 


VFD 




60/0 




VFD 




60/0 




VFD 




60/0 




VFD 




12/2,48/0 


SELECT EXECUTING JOB 


VFD 




60/0 




VFD 




60/0 




VFD 




60/0 




VFD 




60 /220000B 


CLEAR PAUSE BIT AND SI 


VFD 




60/0 


COMMENT TO DAYFILE 


VFD 




60/0 




VFD 




60/0 




VFD 




60/0 




MAIN 


PROGRAM 




SYSTEM 


QAC,R,BL0CK 


CALL QAC 


ENDRUN 






END 




RESTART 
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GET REQUEST 

The GET request attaches one of your queued files to your job in read mode. 

The attached file can be returned to the queue with a DSP call or a ROUTE macro. The user 
program can drop the attached file by issuing a RETURN macro. If the file remains attached 
when the job terminates, the file is returned to the queue from which it was attached. 

The format of the remainder of the parameter block for a GET request is as follows: 



addr + 14 
+ 15 
+ 16 
+ 17 



59 




29 : 


26 


23 


11 


s 


dayfile random addr 


sc 


user limits 


interrupt random addr 


yyyyy, space cd 


W/,. 


rep 


file length 


al 


fl'i 


W//////////////M 


reserved for installations 



Field Description 

dayfile QAC enters the random address of the first PRU of the queued file's 
random dayfile. If the file does not contain a dayfile, QAC enters a value of 
addr zero. This field applies only to print files. 

sc QAC enters the service class of the file. Refer to appendix E for a 

list of valid service classes and their corresponding 6-bit octal values . 

user QAC enters your authorized resource limit that applies to the type of 
limits device to which the file is routed. A value of 77777777g is defined 
as unlimited. This field applies only to output files. 

interrupt If a GET request was previously performed on a file and the file was 
random later returned to the queue, QAC enters file position from the time the 
addr file was returned to the queue. This value can be used to reposition 
the file. 

space cd QAC enters the spacing code of the queued file. This field applies only 
to print files. 

rep QAC returns the repeat count specified for the queued file. This field 
applies only to output files. 

file QAC enters the length of the file in PRUs. 
length 

al QAC enters the security access level of the file. 

fi QAC enters the file size index of the file. 
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An extended version of the GET function can be selected by entering a length of H2g in 
the len field in word addr+1 of the QAC parameter block. The extended GET function returns 
additional accounting information and control information for remote host files. 

QAC returns the following information to addr+20g through addr+106s of the QAC parameter 
block for an extended GET request. Extended GET request parameter block (len field of 
addr+1 of QAC parameter block = 112g): 





59 


47 


23 


17 


11 


addr + 20 


accounting information (word AHMT) 


+ 21 


accounting information (word AHDS) 


+ 22 


accounting information (word AACW) 


+ 23 


owner user name 


+ 24 


owner family name 


+ 25 


creation user name 


+ 26 


creation family name 


+ 27 


remote mainframe user name 


+ 30 


remote mainframe family name 


+ 31 


user job name 


+ 32 


data dec 


| imp length 


exp length 


+ 33 
+ 64 


implicit remote text string 


+ 65 
+ 106 


explicit remote text string 


+ 107 


encrypted batch password for input file (SSJ- only) 


reserved for CDC 


+ 110 
+ 112 


reservcu ior CDC 



Field 



Description 



accounting Accounting words AHMT, AHDS, and AACW for the file. Refer to the 
information N0S 2 Administration Handbook for descriptions of these words. 



owner user 
name 



The user name of the owner of the file. 



owner family 
name 



The family name of the owner of the file. 



creation 
user name 



The user name of the creator of the file, 



creation 
family name 



The family name of the creator of the file. 



remote For remote host files, the user name under which the file is 
mainframe accessed on a remote mainframe . For other files , this field has a 
user name value of zero. 
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Field 



Description 



remote 
mainframe 
family name 

user job 
name 



For remote host files, the family name under which the file is 
accessed on a remote mainframe. For other files, this field has a 
value of zero. 

The user job name for the file. 



data dec Data declaration field from DSP parameter block (files routed to 
remote mainframe using extended DSP request only) . 

imp length Character length of implicit remote text string (remote host files 
only). 

exp length Character length of explicit remote text string (remote host files 
only). 

implicit For remote host files, a string of up to 400s characters that 
remote text contains parameters for the operating system under which the file 
string was created. For other files, this field has a value of zero. 

explicit For remote host files, an optional string of up to 400g characters 
remote text that form a job command in the job control language of the operating 
string system of the mainframe that is to process the file. For other 
files, this field has a value of zero. 



PEEK REQUEST 



The PEEK request examines selected queued files or executing jobs, and returns information 
about those files and/or jobs to the QAC buffer. The user program specifies which 
files/ jobs QAC is to consider by setting the appropriate selection flags and their 
corresponding fields in words addr+0 through addr+13g of the parameter block and selects 
the information about those files/jobs that QAC is to return. 

You can use the PEEK request to obtain a count of queued files and executing jobs that 
belong to you. To do this, include a PEEK request in your program without setting any peek 
information bits; QAC will enter the nunber of queued files and executing jobs for your 
user name in words addr+14g and addr+15g. 

When the QAC buffer is filled with PEEK reply information during a PEEK request , QAC enters 
the QFT or EJT ordinal of the file or job last examined in the ejt/qft ord field of addr+4 
and enters the queue last examined in the queue field of addr+4. To issue a continuation 
call, the user program clears the completion bit (addr+0) and empties the QAC buffer by 
setting out (addr+3) to the value of in (addr+2). The program then reissues the RA+1 call. 
QAC continues its search from the file or job at which it was interrupted. 

The format of the remainder of the parameter block for a PEEK request is as follows: 

59 47 35 23 11 

addr + 14 ' 

+ 15 

+ 16 

+ 17 



incnt 


excnt 


prcnt 


phcnt 


plcnt 


vrtcnt 


W/////////////////A 


iscnt 


ent length 


peek information bits 


reserved for installations 
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Field 



Description 



incnt If no peek information bits are set (addr+168), QAC enters the number 
of files in the input queue that are eligible for selection. In order 
for any input queue files to be eligible for selection, the user program 
must set bit of the queue sel field, addr+lOg. 

If any peek information bits are set , the user program must enter the 
maximum number of files to be selected from the input queue. When the 
PEEK request is completed, QAC enters the actual number of input queue 
files selected. 



excnt This field is used in the same manner as the incnt field, except that it 
applies to jobs in the executing job queue. In order for any jobs in 
the executing job queue to be eligible for selection, the user program 
must set bit 1 of the queue sel field, addr+lOg. 

prcnt This field is used in the same manner as the incnt field, except that it 
applies to files in the print queue. In order for any print queue files 
to be eligible for selection, the user program must set bit 2 of the 
queue sel field, addr+lOg. 

phcnt This field is used in the same manner as the incnt field, except that it 
applies to files in the punch queue. In order for any punch queue files 
to be eligible for selection, the user program must set bit 3 of the 
queue sel field, addr+lOg. 

plcnt This field is used in the same manner as the incnt field, except that it 

applies to files in the plot queue. In order for any plot queue files 

to be eligible for selection, the user program must set bit 4 of the 
queue sel field, addr+lOg. 

wtcnt This field is used in the same manner as the incnt field, except that it 
applies to files in the wait queue. In order for any wait queue files 
to be eligible for selection, the user program must set bit 5 of the 
queue sel field, addr+lOg. 



iscnt 



This field is reserved for installations . 



ent QAC enters the length, in words, of each reply in the peek reply buffer. 

length If no peek information bits are set, QAC enters a value of zero. QAC 

creates a block of replies that all have the same length; any words in a 
particular reply that are not defined for the queue type of the reply 
contain zeros. 

peek The bits in this word correspond to the octal numbers in the lower 6 bits 
information of words in the peek reply block. Each bit that is set In this word 
bits causes QAC to return the information shown in the corresponding word of 
the peek reply block. Certain bits select information contained in more 
than one word in the reply block: bit 14 selects message buffer one for 
the control point area (MS1W), bit 15 selects message buffer two for the 
control point area (MS2W), bit 18 selects dayfile messages, bit 19 
selects the command buffer, and bit 24 selects the remote text string. 

Symbols for these peek information bits are defined in the system OPL 
common deck COMSQAC. 
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For each file or job that satisfies the selection criteria specified in the QAC parameter 
block, QAC returns a PEEK reply block to the QAC buffer. Each PEEK reply block has the 
following format. 





59 


53 


47 


44 


41 


35 


29 


23 


17 


11 


5 


out + 


jsn 


ordinal 


queue 





01 1 


+ 1 


sc 


ot 


forms 


disp 


ec 


ic 





02 1 


+ 2 


priority 


fl-em 


fl-cm 








03t 


+ 3 


destination family 








04t 


+ 4 


destination un 


id 





05t 


+ 5 


creation family 








06t 


+ 6 


creation un 


cid 





07t 


+ 7 


dfo 


destination ui 


cfo 


creation ui 





10t 


+ 10 


user job name 








lit 


+ 11 


space cd 


I 


' 


rep 


account limit 





12t 


+ 12 


estb 


creation date + time 





13 1 


+ 13 


file length 


creation jsn 





14t 


+ 14 


ejt stat 





• 
c 


scheduling field 





15t 


+ 15 





lenl 


lit 


16tt 


+ 16 


MS1W characters 1-10 






+ 17 


MS1W characters 11-20 


+ 20 


MS1W characters 21-30 






+ 21 


MS1W characters 31-40 


+ 22 


MS1W characters 41-50 


+ 23 





Ien2 


1ft 


17 tt 


+ 24 


MS2W characters 1-10 


+ 25 


MS2W characters 11-20 


+ 26 


MS2W characters 21-30 






+ 27 


SRU limit 





20t 


+ 30 


SRUs accumulated 





21 1 


+ 31 





alen3 


Ien3 


1 


22tt 


+ 32 


dayfile messages (first word) 




r 


'< 4 s 


+ 141 


dayfile messages (word |len3) 


+ 142 





afart 


Ien4 


1 


23tt 


+ 143 


commands (first word) 






; 


5 ds 


+ 252 


commands (word Ien4) 



tThis field has a value of zero if the rest of the word contains all zeros. 
ttThis field has a value of zero if the following word contains all zeros. 
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59 


47 


35 


29 


23 


20 17 14 


11 


5 


+ 253 





dlid 


slid 





24t 


+ 254 


] den 


wlen 


Iff 


25ft 


+ 255 


implicit remote text string (characters 1—10) 


4 

9 


v - - 


+ 306 


implicit remote text string (characters 251-256) 






+ 307 





clen 


wlen 


Itt 


26tt 


+ 310 


explicit remote text string (characters 1—10) 


i 


i 






it 


+ 341 


explicit remote text string (characters 251—256) 






+ 342 


remote mainframe user 





27t 


+ 343 


remote mainframe family 





30t 


+ 344 





la 


ua 


al 





3lt 


+ 345 


reserved for installations 


It 


72t 


+ 346 


reserved for installations 


It 


73t 



Field 
jsn 

ordinal 
queue 



sc 
ot 
forms 



Description 
The job sequence name of the selected job or file. 
The EJT or QFT ordinal of the selected job or file. 
The queue in which the job or file is located. 
Bit(s) Queue 

Input queue. 

1 Executing job queue. 

2 Print queue. 

3 Punch queue. 

4 Plot queue. 

5 Wait queue. 

6-7 Reserved for Control Data. 

8 Reserved for installations; 

9-11 Reserved for Control Data. 

The service class of the job or file. 

The origin type of the job or file. 

The forms code for the file. Does not apply to jobs in the 
executing queue or files in the input queue. 



tThis field has a value of zero if the rest of the word contains all zeros. 
ttThis field has a value of zero if the following word contains all zeros. 
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Field 



Description 



disp 



The disposition code assigned to the file. Does not apply to jobs. 

The external characteristics of the file. Does not apply to entries 
in the executing queue or the input queue. 



ic 



The internal characteristics of the file. Does not apply to entries 
in the executing queue or the input queue. 



priority The priority of the file at the time the PEEK request took place. 

Does not apply to executing jobs. 



fl-em 



The current extended memory field length for the job. Applies only 
to jobs in the executing queue. 



fl-cm 



The current central memory field length for the job. Applies only to 
jobs in the executing queue. 



destination The destination family for the file, if the file is not 

family routed to a local batch device. This represents the family under 

which you would have to log on to a remote batch terminal in order to 
access the file. A value of zero is entered if the file is routed to 
a local batch device. 

destination The destination user name for the file, if the file is not 

un routed to a local batch device. This represents the user name under 

which you would have to log on to a remote batch terminal in order to 
access the file. A value of zero is entered if the file is routed to 
a local batch device. 



id 



The destination batch device ID, if the file is routed to a local 
batch device; otherwise, zero. 



creation 
family 



The family on which the file or job was created. 



creation 
un 



The user name under which the file or job was created. 



cid 



The device ID of the device at which the file or job was created, if 
it was created at a local batch device; otherwise, zero. 



dfo 



The family ordinal corresponding to the destination family in word 
out+3. A value of zero indicates no family ordinal. 



destination The user index corresponding to the destination user name in 
ui word out+4. A value of zero indicates no user index. 



cfo 



The family ordinal corresponding to the creation family in word 
out+5. A value of zero indicates no family ordinal. 



creation The user index corresponding to the creation user name in 

ui word out +6. A value of zero indicates no user index. 



user job 

name 



The user job name associated with the file or job. 
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Field 



Description 



space cd 



The spacing code for the entry. Does not apply to jobs in the 



This bit is set if the file is interrupted. Applies only to output 
files. 



rep 



account 

limit 



The repeat count for the entry. Does not apply to jobs in the 
executing queue or files in the input queue. 

The user's validated resource limit that applies to the type 
of device to which the file or job is routed. A value of 77777777g 
is defined as unlimited. Does not apply to jobs in the executing 
queue or files in the input queue. 



esto The EST ordinal of the device on which the file resides. Does not 
apply to jobs in the executing queue. 

creation The packed date and time when the file was first queued. The 
date+time six 6-bit octal fields contain the following: year minus 1970, 
month, day, hour, minute, and second. 

file The length of the file in PRUs. Does not apply to jobs in 

length the executing queue. 

creation The job sequence name of the job that created the file or job. 
jsn 

ejt stat The status field of the EJT entry. Applies only to executing jobs. 
Bits 1 through 5 contain the EJT job status of the job; bits 7 
through 10 contain the EJT connection status of the job. Refer to 
appendix E for a listing of valid EJT status codes and their meanings. 

c CPU status. Applies only to executing jobs. 

Value Description 

Null status. 

' 1 A status (job active in CPU 0). 

2 B status (job active in CPU 1). 

3 Not used. 

4 W status (job waiting for CPU). 

5 X status (job waiting for recall). 

6 I status (job waiting for PP drop). 

7 Not used. 

scheduling The contents of this field depend on the EJT status of the 

field job. Applies only to jobs in the execution queue. Refer to appendix 

E for a description of the scheduling field associated with each EJT 

status code. 



lenl 
MS1W 



The length of MS1W in words. This field always has a value of five. 

The message in message buffer 1 of the job's control point area. The 
message can contain up to 50 characters; if the message is less than 
50 characters long, it is terminated by the standard display coded 
line terminator sequence. 
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Field 



Description 



len2 The length of MS2W in words. This field always has a value of three. 

MS2W The message in message buffer 2 of the job's control point area. The 

message can contain up to 30 characters; if the message is less than 
30 characters long, it is terminated by the standard display coded 
line terminator sequence. 

SRU limit The job's SRU limit (from the job control point area). 

SRUs The current number of SRUs accumulated by the job (from the 

accvniulated job's control point area). 

alen3 The number of nonzero words in the dayfile message entry. 

Ien3 The length of the dayfile message entry in words. This field always 

has a value of 114g. 

dayfile QAC enters a copy of the job's dayfile buffer. Dayfile 

messages messages have the standard display coded line format. 

alen4 The number of nonzero words in the commands entry. 

Ien4 The length of the commands in words. This field always has a value 

of 110g. 

commands QAC enters a copy of the job's command buffer. Commands already 

executed and commands not yet read into the buffer do not appear. 
Commands have the standard display coded line format. 

dlid Destination logical identifier for the file. 

slid Source logical identifier for the file. 

den The length of the implicit or explicit remote text string in 

characters. 

wlen The length of the Implicit or explicit remote text string in words. 

implicit A string of up to 400g characters that contains parameters for the 

remote text operating system under which the file was created. This string is 
string present only for remote host files. 

explicit A string of up to 400g characters that form a job control command 

remote text in the job control language of the operating system of the mainframe 
string that is to process the file. This string is present only for remote 

host files. 

remote The user name under which you would have to log on to a remote batch 

mainframe terminal in order to access the file at the destination mainframe, 

user This word is present only for remote host files. 

remote The family name under which you would have to log on to a remote 

mainframe batch terminal in order to access the file at the destination 

family mainframe. This word is present only for remote host files. 
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Field 

la 

ua 

al 



Description 
The lower access level limit of the input file or job. 
The upper access level limit of the input file or job. 
The current access level of the file or job. 



Example : 



The following program locates up to 10 executing jobs that were submitted under the 
same user name as the program. All information about those jobs is stored in the 
PEEK reply buffer and is dumped. This program uses the SYSTEM macro (refer to 
section 11) to issue the QAC request. 





IDE NT 


PEEKJOB 




ENTRY 


MAIN 


** 


QAC PARAMETER BLOCK 


BLOCK 


BSS 







VFD 


59/3,1/0 




VFD 


36/0,6/11,18/REPLY 




VFD 


42/0,18/REFLY 




VFD 


42/0,1 8/ RE PLY 




VFD 


42/0,18/REPLY+1000 




VFD 


£0/0 




VFD 


60/0 




VFD 


60/0 




VFD 


12/2,48/0 




VFD 


60/0 




VFD 


60/0 




W-D 


60/0 




VFD 


12/0,12/10,36/0 




VFD 


60/0 




VFD 


37/0,23/-0 




VFD 


60/0 


** 


MAIN I 


PROGRAM 



MAIN SYSTEM QAC,R,BL0CK 

SYSTEM DMD,R,BL0CK+15,BL0CK 
SYSTEM DMD,R,REPLY+1000,REFLY 
ENDRUN 

** PEEK REPLY BUFFER 

REPLY BSSZ 1001 

END MAIN 



PEEK FUNCTION CODE 

PEEK REPLY BUFFER, FIRST 
, IN 
, OUT 
, LIMIT 



SELECT EXECUTING JOB QUEUE 

SELECT UP TO 10 ENTRIES 
SELECT ALL INFORMATION 



CALL QAC 

DUMP UPDATED PARAMETER BLOCK 

DUMP PEEK REPLY BUFFER 



REFLY BUFFER 
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SYSTEM T!ME/ DATE REQUESTS 



NOS provides several system requests associated with the time and date. These requests are 
processed directly by CPUMTR. Unless otherwise noted, the only common deck required for 
absolute assemblies is COMCSYS. 

The format of the RA+1 call to the time function processor is: 



59 



40 



35 



w 



23 



17 



RA + 1 



TIM 



code 



addr 



Auto recall bit. 



code 



Function code as follows: 



Code 



Macro 



0000 


TIME 


0001 


DATE 


0002 


CLOCK 


0003 


JDATE 


0005 


RTIME 


0006 


PDATE 


0007 


STIME 


0011 


HTIME 


0012 


HTIME 



Description 

Accumulated CP time used by the job. 

Current date in display code. 

Current time of day in display code. 

Current Julian date. 

Elapsed real time since last deadstart. 

Current date and time in packed binary form. 

Accumulated system resource units. 

Accumulated clock cycle count for control point , 

Accumulated clock cycle count since deadstart. 



addr 



Address of a reserved one-word block that will receive the reply. 



The EDATE and ETIME macros described in this section do not have an RA+1 call. They are 
processed by common deck C0MCEDT and are used to convert the format of a date and time 
returned by a previous macro call. 
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CLOCK 



In response to the CLOCK function, the system returns the current time of day in display 
code to location addr. 

Macro format: 

Location Operation Variable 



CLOCK 



addr 



addr Address of reply word. 

Reply word format (display code) : 



59 53 



addr | A j hh 



41 35 



23 17 



5 



A 

hh 



Space (display code 55g), 

Hours. 

Minutes. 

Seconds . 



DATE 

In response to the DATE function, the system returns the current date in display code format 
to location addr. 



Macro format : 

Location Operation 

DATE 



Variable 



addr 



addr Address of reply word. 

Reply word format (display code): 



59 53 



41 35 



23 17 



addr A 



yy 



dd 



A 

yy 

mm 
dd 



Space (display code 55g), 
Year (last two digits). 
Month. 

Day. 
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EDATE 



EDATE converts the packed date In address pdate to display code and enters the converted 
date in register X6* 

Macro format :t 



I 

I 



EDATE 



pdate 



pdate Register or address containing packed date to be converted. 

Format of address or register containing packed date: 



pdate 



59 


7 


n 


5 





yy 


mm 


da 



yy 



dd 



Year minus 1970. 

Month. 

Day. 



Upon completion, register X6 contains the following (display code): 

59 53 41 35 23 17 5 



(X6) A 



yy 



/ 



/ 



dd 



A 

yy 

QHQ 

dd 



Space (display code 553), 
Year (last two digits). 
Month. 
Day. 



This macro requires the common decks COMCEDT and COMCCDD. 



tThis macro is not available In SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 
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ETIME 

ETIME converts the packed time in address ptime to display code and enters the converted 
time in register X6. 

Macro format :t 

Location Operation Variable 

ETIME ptime 

ptime Register or address containing packed time to be converted. 

Format of address or register containing packed time: 

59 17 11 5 

T77777777777777777777777777777777777777 

ptime 



M^%%%%^^^ 


hh 


mm 


ss 



hh Hours . 

mm Minutes . 

ss Seconds. 

Upon completion, register X6 contains the following (display code): 



59 53 



41 35 



23 17 



5 



(X6) A 



hh 



A 

hh 



Space (display code 55g). 

Hours. 

Minutes. 

Seconds . 



This macro requires the common decks COMCEDT and COMCCDD. 



f This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 
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HTIME 

HTIME returns the model 176 accunulated CPU clock cycle count (If available) either for the 

/, ***"*"^ r ** - ** rt ^ ^r since the last system deadstart 

nanoseconds. 

Macro format: 



Location 



Operation 



Variable 



HTIME 



addr ,op 



addr 



op 



Address of reply word. 

Option desired; if 0, accumulated clock cycle count for the current job 
is returned (function code 11); if 1, accumulated clock cycle count 
since the last system deadstart is returned (function code 12). 



Reply word format : 



59 



47 



addr 



typ« 



CPU dock cycl* count 



type If the model 176 CPU clock cycle count is available, type is 20008. 

If the model 176 CPU clock cycle count is not available, type is 6000g. 

JDATE 

JDATE returns the current Julian date, in display code, to location addr. 
Macro format: 



Location Operation 



Variable 



JDATE 



addr 



addr Address of reply ward. 

Reply word format (display code): 



59 



addr 



29 



17 






yy 


ddd 



yy Julian year , 
ddd Julian day. 
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PDATE 

PDATE returns the current date and time in binary packed format. The user program can 
unpack the parameters or use the EDATE and ETIME macros to do the unpacking. 

Macro format: 

Location Operation Variable 

PDATE addr 

addr Address of reply word. 

Reply word format: 



59 



addr 



35 29 23 17 11 5 






yy 


mo 


dd 


hh 


mm 


$• 



yy 


Year minus 1970. 


mo 


Month. 


dd 


Day. 


hh 


Hours . 


mm 


Minutes . 


ss 


Seconds. 



RTIME 

RTIME returns the real-time clock reading to location addr. This is the elapsed time since 
deadstart. 

Macro format : 

Location Operation Variable 

RTIME addr 

addr Address of reply word. 

Reply word format: 



59 



35 



addr 



seconds 


milliseconds 



seconds Time since deadstart in seconds, 
milliseconds Time since deadstart in milliseconds. 
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STIME 

STIME returns the job's accumulated system resource units (SRUs) . Refer to the NOS 2 



Analysis Handbook lOl a description Oi oau3« 
Macro format : 

Location Operation Variable 

STIME addr 

addr Address of reply word . 



Reply word format: 
59 



addr 2000 



35 



0000 



I 
I 



milliunits 



milliunits Accumulated system resource units/1000. 



TIME 

TIME returns the accimulated central processor time used by the job to location addr. 
Macro format: 

Location Operation Variable 

TIME addr 

addr Address of reply word. 

Reply word format: 

59 47 35 11 



addr 2000 



0000 



seconds 



millisecond* 



second s 



Accumulated central processor time in seconds. 



milliseconds Accumulated central processor time in milliseconds 
(modulo 1000). 



NOTE | 



In order to use the values returned by the 

TIME macro to determine total accimulated 
central processor time, the user program 
must perform the following conversion: 

Total time (milliseconds) = (seconds x 
1000) + milliseconds. 

Attempting to use bits 35 through as a 
single quantity will produce meaningless 
results. 



60459690 D 



9-7 



ir\B fr\Kiror\i 



TRANSLATE CONTROL STATEMENT 

Translate control statement (TCS) processes user requests to read a command from or to place 
a command into the stream, The only common deck required for absolute assembly is COMCSYS. 

The format of the EA+1 call is : 



59 



RA + 1 



40 



35 



23 



17 



TCS 


■m 


code 


sf 


oddr 



R 


Auto rec 


all 


bit. 




code 


Func tion 

Code 

004 
005 


cod 


e: 


Macro 

CONTROL 
EXCST 



sf 



Subfunction code for the CONTROL macro. 
EXCST macro . 



This field is not used for the 



sf 



Action 



addr 



00 Read the next command and advance the command pointer. 

01 Read the next command only if it does not call for a load from a 
local file or from a global library set. Do not advance the 
command pointer. 

02 Read the next command even if it calls for a load from a local 
file or from a global library set. Do not advance the command 
pointer . 

4x If the next command being read should be processed in product 
set format, sf should be set to 4x, where x can be 0, 1, or 2, 
corresponding to one of the above options. If sf is not set to 
4x, command parameters are to be processed in NOS format. 

First word address of the buffer in which the command is to be stored or 
from which the command is to be read. 
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CONTROL (004) 

The CONTROL macro allows the user program to read the next command in the command stream and 
transfer it to a specific address. The command is checked for syntax errors, and all 
parameters are stored as if a program load had actually taken place. 

If no command exists, binary zero words are returned to the buffer. If the next command is 
of the form: 

* comments 

the command is returned to the buffer if the comments string ends with a period or right 
parenthesis. Otherwise, the binary zero words are returned to the buffer. 



Macro format : 



Location 



Operation 



Variable 



CONTROL 



addr,rss,lf ,psf 



addr 



rss 



If 



psf 



First word address of the buffer in which the next command is to be 
stored. The user program should allow room for eight words (80 
characters). 

If rss is specified (any value may be used), the command pointer is not 
advanced. This allows the user program to determine what the next 
command is and still allow it to be processed. If rss is not specified, 
the command pointer is advanced as if the command had been processed. 

If rss is not specified, If is ignored. If the following are true: 

• rss is specified, 

• If is not specified, 

• the command to be read calls for a load from a local file or 
from a global library set, 

the command will not be read. If rss and If are both specified (any 
value may be used for If), the command will always be read. If the 
command calls for a load from a local file or from a global library set, 
bit 17 or RA+64s will be set. 

If psf is specified (any value may be used), parameters are unpacked in 
product set format . 
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The command parameters are stored in the job communication area (refer to figure E-l) 
beginning at ARGR (RA+2) through RA+n (n cannot exceed 63 8 ). These parameters are 
terminated by a zero word. The number of parameters stored in the job communication area is 
"laced in the lower 18 bits of ACTR (RA+64n1, The name of the co mma nd is "laced in bits 
59 through 18 of PGNR (RA+64g). The parameters are stored in either operating system or 
product set format, depending on psf. The command image, less any label or prefix field, is 
stored beginning at addr. 

If the parameters are stored in operating system format, the comma, period, and right 
parenthesis are stored as zero. For all parameters and valid separators except the comma, 
their display code equivalent is stored. 

If the parameters are stored in product set format, separators and terminators are stored as 
follows: 

Character Code (Octal) 

1 

2 

/ 3 

( 4 

+ 5 

6 

; 10 

) or . 17 

Others 16 

The manner in which CONTROL stores the command is identical to the way the system normally 
processes commands, except that the command image is stored at the specified address. When 
the system processes a command, the command image is stored beginning at CCDR (RA+70g). 
Calling the CONTROL macro does not affect the contents of CCDR. 

Example : 

The following program reads the next command in the command stream (advancing the 
command pointer), stores the parameters in operating system format, and transfers the 
command image to the specified buffer. 

IDENT CMND 
ENTRY CHND 

CMBUF BSS 8 

CMND CONTROL CMBUF 

SYSTEM DMD,R,63B,2 

SYSTEM DMD,R,CMBUF+7,CMBUF 

ENDRUN 

END CMND 
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When the program is executed from a batch job or in a procedure file and is followed in 
the command stream by: 

TEST,A=B,C=D,E,F. 

the contents of central memory are displayed as follows: 



ARGR 



RA+2 


0100 


0000 


0000 


0000 


0054 


A 


+3 


0200 


0000 


0000 


0000 


0000 


B 


+4 


0300 


0000 


0000 


0000 


0054 


c 


+5 


0400 


0000 


0000 


0000 


0000 





+6 


0500 


0000 


0000 


0000 


0000 


E 


+7 


0600 


0000 


0000 


0000 


0000 


F 


+10 


0000 


0000 


0000 


0000 


0000 





CHBUF +0 2405 2324 5601 5402 5603 TEST,A=B,C 
+1 5404 5605 5606 5700 0000 =D,E, F. 



If the macro call is changed to 
CONTROL CMBUF,,,PSF 

the command parameters are stored in product set format and the contents of locations 
RA+2 through RA+lOs appear as follows : 



ARGR 



RA+2 


0100 


0000 


0000 


0000 


0002 


A 


B 


+3 


0200 


0000 


0000 


0000 


0001 


B 


A 


+4 


0300 


0000 


0000 


0000 


0002 


c 


B 


+5 


0400 


0000 


0000 


0000 


0001 


D 


A 


+6 


0500 


0000 


0000 


0000 


0001 


E 


A 


+7 


0600 


0000 


0000 


0000 


0017 


F 





+10 


0000 


0000 


0000 


0000 


0000 
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EXCST (005) 

With the EXCST macro the user program specifies a buffer containing a command. Control is 
nouoiciicu i-LMu uiic 1-a.i.j. uig ^ivgiwu i-v uijc 0JT0I.CU1, wiio.cii Ledub i-iie comnana } places it in 
the command stream, and processes it. Control is not returned to the calling program. The 
command must conform to NOS command format conventions described in Volume 3, System 
Commands. 

Macro format : t 

Location Operation Variable 

EXCST addr 

addr First word address of the buffer containing the command to be processed. 

The system begins reading at addr and continues until the end of 
statement (zero byte) or end of buffer (80 characters) is reached. The 
command must be left-justified with zero fill. 



CHECKPOINT/ RESTART 

A job may be terminated at any time as the result of system, operator, or program error. For 
some jobs it becomes more advantageous to accept the overhead of checkpoint procedures than 
to run the risk of losing the entire job output. The checkpoint/restart feature is 
implemented through the CKP command or CHECKPT macro and the RESTART command. Refer to 
Volume 3, System Commands, for discussions of the CKP and RESTART commands. 



CHECKPT 

The CHECKPT macro is used for taking checkpoint dumps. The dump is written on the tape or 
mass storage checkpoint file specified on a REQUEST, ASSIGN, or LABEL command or REQUEST or 
LABEL macro. For a general description of checkpoint dumps, refer to Volume 3, System 
Commands. The CHECKPT macro provides you with greater control than the CKP command in 
specifying the type of copy to be performed. 



NOTE 



A checkpoint is not allowed in a program 
that has issued a PROTECT macro selecting 
user file privacy, in a program that has 
issued a SETSSM macro , or in a program that 
has been loaded from an execute-only file. 



TThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 
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Macro format :t 



Location 



Operation 



Variable 



CHECKPT 



addr,sp 



addr 



sp 



Address of the parameter list identifying the files to be checkpointed. 

Flag indicating whether or not all files assigned to the job are to be 
checkpointed. If sp is specified (any value may be used), only those 
files specified in the parameter block at address addr will be 
checkpointed. If the sp field is not specified, all local files will be 
checkpointed . 



The format of the RA+1 call is: 



59 



40 



w 



35 



17 



RA + 1 



CKP 



SP 



addr 



R 
sp 



Auto recall bit. 

Flag indicating whether or not all files assigned to the job are to be 
checkpointed. If sp is specified (any value may be used), only those 
files specified in the parameter block at address addr will be 
checkpointed. If the sp field is not specified, all local files will be 
checkpointed . 



Address of the parameter block identifying the files to be checkpointed. 




Latest checkpoint number. 

Octal number of entries in the parameter list (0<n<77g), 



i This macro is not available in SfSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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lf n i Identifies file to be checkpointed; Ifni is left 
fi Specifies the manner in which lfni is to be copied: 
f i Description 

The mass storage file is copied from the BOI to its position 
at checkpoint; only that portion is available for restart. 
RESTART positions the file at the latter point. 

1 The mass storage file is copied from its position at 
checkpoint to the EOI; only that portion is available for 
restart. RESTART positions the file at the former point. 

2 The entire mass storage file is copied. RESTART sets the 
file to its position at checkpoint time. 

3 The last operation on the file determines how the mass 
storage file is copied. 

Last Operation f Selected 

Write f i= o 

Read (EOI detected) No copy 
Read (EOI not detected) f^=2 

4 The information table associated with the file is copied but 
the file Itself is not copied. The information table 
contains FNT/FST information and the random address of the 
mass storage file or the block count of the magnetic tape 
file. RESTART retrieves the file in some cases (refer to 
RESTART) and sets it to its position at checkpoint time. If 

*i=4 and the file is a mass storage file, RESTART assumes 
it is an indirect access file and issues a GET macro to 
obtain a working copy. 

If a value other than 4 is specified for a magnetic tape file, a warning 
message is issued and the file is processed as if f ^ =4 had been 
specified, f^ =4 is also forced for execute-only files. 

The following list shows the type of operation CHECKPT performs for the different values of 
sp and n. 

sp n Operation 

All files assigned to the job at checkpoint time are processed according 
to the last ODeration performed. 



any 



to the last operation performed. 



#0 All files assigned to the job at checkpoint time are processed. The n 
files included in the parameter list are processed according to their 
respective f values. All other files are processed according to the 
last operation performed. 

4 4 The n files specified in the parameter list are processed according to 
their respective f values. 
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The procedure scratch files ZZZZZCO, ZZZZZC1 , and ZZZZZC2 are always checkpointed; they are 
copied from BOI to EOI (refer to f ± = 2 ), regardless of the sp and n values. 

The INPUT, OUTPUT, PUNCH, PUNCHB, P8, and LGO files, and procedure data files ZZCCLAA 
through ZZCCLZZ are always checkpointed; they are copied according to the last operation 
performed (refer to fi=3), regardless of the sp and n values. 

For all other files except direct access files, the default copy type is f=4 when n^O. 
For direct access files, the type of copy CHECKPT makes depends on the access mode. 





Mode 


User Option 


Default 


w 


Write 


Any type of copy 


Copied (f=3) 


R 


Read-only 


Any type of copy 


Not copied (f=4) 


E 


Execute-only 


Only f=4 


Not copied (f=4) 


A 


Append-only 


Any type of copy 


Copied (f=3) 


M 


Modify 


Any type of copy 


Copied (f=3) 


RA 


Read/allow append 


Any type of copy 


Copied (f=3) 


RM 


Read/allow modify 


Any type of copy 


Copied (f=3) 


U 


Update 


Any type of copy 


Copied (f=3) 


RU 


Read /allow update 


Any type of copy 


Copied (f=3) 



For a random file the copy type must be f=2 or it will be copied according to the last 
operation performed (f=3). 

If f=4 is selected, you may have to retrieve the file yourself at restart time and select 
the NA and FC options on the RESTART command (refer to Volume 3, System Commands). 



REPRIEVE PROCESSING 

Reprieve processing (routine RPV) enables the user program to intercept interrupts prior to 
an abort of the program and to take corrective action. This action can be the completion of 
files (such as flushing buffers or closing files) and tables or it can be an attempt to 
correct the problem. 

The format of the call to RPV is as follows: 



59 



40 



17 



m 



RA+1 



RPV 



addr 



R Auto recall bit. 

addr First word address of the parameter block. 
RPV supports the following functions. 

• SETUP 

• RESUME 

• IRESUME 

• RESET 
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The SETUP function is used to initialize the parameters for the RPV interface (that is 
setting the mask bits that indicate which errors are to be intercepted). It also initializes 
all RPV data in the job's control point area; if the parameter block indicates pending 

■f n(-en*v>iin4-n r* v I / 1 \ v*i«i/-> ct +- e> fhyiTr n-*-n. ni-y-. a a n n A .4 « +- *• I* - *- *~ -t 

The interrupt handler is that portion of your program that processes interrupts. When an 
error occurs, the system will interrupt your program and restart it at the address that was 
specified in the RPV block. At this point, your program is running in interrupt handler 
mode which will prevent further errors from interrupting the program until the program has 
completed processing the first error. 

The resume functions are used to restart the program after an interrupt has been processed. 
Any pending interrupts that occurred during the processing of the previous interrupt are 
detected then and the interrupt handler is restarted to process these interrupts. 
Optionally, the mask bits can also be changed during a resume function. Two modes of resume 
are allowed: program mode and interrupt handler mode. 



NOTE 



If the interrupt being processed is a CPU 
error exit, a resume function is not possible 
without manipulation of the exchange package 
and, in most cases, is not practical even 
with such manipulation. 



The program mode resume (RESUME) will cause the system to restart the program at the 
interrupt point. The interrupt handler mode will be cleared so that any additional errors 
will cause a new interrupt of the program. Also, any errors which occurred during interrupt 
handler mode processing will cause a new interrupt at this time. 

The interrupt handler mode resume (IRESUME) will cause the system to restart the program at 
the point of interrupt, but without clearing the interrupt handler mode. This allows the 
program to complete the task it was engaged in before the interrupt, and to then process the 
error and terminate the program at some later time. 



NOTE 



Further interrupts will be inhibited after 
the IRESUME is processed. Normal processing 
may be resumed by issuing another REPRIEVE 
SETUP. 



The RESET function is used to reset a previous error flag and allow the operating system 
error handling routines to process the error. That is, the mask bits are cleared to disable 
further reprieve processing and the system processes the error as if the appropriate mask 
bit had not been set. Pending interrupts are not processed; however, any pending RA+1 
request is reset and the exchange package is reset from the reprieve parameter block. 
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RPVBLK 

The RPVBLK macro creates a REPRIEVE parameter block. 
Macro format : t 



Location 



tag 



tag 
xfer 
xjp 
chklwa 



Operation 



Variable 



RPVBLK xfer ,xjp, chklwa 

Symbol for address of parameter block. 

Address of error processing routine (transfer address). 

Symbol for address of exchange package within parameter block (optional) 

Checksum last word address (optional). 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck CCMCCMD (refer to appendix F) . This macro requires common 
deck COMSRPV. 
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The format of the parameter block is as follows: 





59 






35 


29 


23 






n 


9 





oddr +0 





length 





func 


c 


+ 1 


checksum lwa 


transfer address 


*2 


srietwiiKi saiys 


+ 3 


mask 


error class 


error code 


44 


pending interrupts 


+5 


pending RA+1 request 


+6 


interrupted terminal J/0 


+ 7 


reserved 


error flag 


+10 






reserved 


reserved inst 


+11 

• 
• 
• 
• 
+30 


exchange package 

i 
i 



length 



Length of the parameter block including the exchange package 
area (minimum of 31g words). 



func 



Function code: 



checksum 
lwa 



transfer 
address 



1 SETUP. 

3 BESET. 

4 Interrupt handler mode resume (IRESUME). 

Completion bit (set by RPV when operation is complete). 

Specified by the user to indicate the end of the area to be 
checksummed and compared or set. If zero, no checksum is 
desired (checksum area begins at transfer address). 

Address to which control is transferred when an interrupt is 
processed. 



checksum 
value 



Either set to the checksum of the indicated area when RPV is 
called, or compared against the computed checksum (if 
checksum lwa is specified) when a reprievable error is 
processed . 
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mask 



Indicates which types of interrupts are to be intercepted so 
that they may be processed in the program. If a particular 
bit is set in the mask, the corresponding error class will 
be intercepted; if a bit is clear in the mask, the 
corresponding error class will be processed by the system. 
If mask=0, extended reprieve processing is cleared. 



error classtttt 



jodetttt 



mask 


Error Class 


001 


CPU error exit .t 


002 


PP call error. 


004 


SRU limit. 


010 


Operator termination .tt 


020 


PP abort. 


040 


CPU abort. 


100 


Normal termination. 


200 


Terminal interrupt .ttt 



Set to the value of the mask bit which intercepts the 
indicated error (that is, if error x is intercepted by mask 
bit n, then bit n in the error class field is set). Refer 
to table 10-1 for a list of error classes. 

Octal code indicating error encountered - Refer to table 10-1 
for a list of error codes and their meanings. 



pending Used to queue pending interrupts (that is, the nth error code 

interrupts sets bit n in this field) . 

pending RA+1 Contents of RA.+1 at time of interrupt. RA+1 is reset from 

requestttttt this field on a resume or reset call. 



interrupted 
terminal l/0ttttt 



Contains interrupted input request if an interrupt occurs 
while a terminal Input request is pending. The format is as 
follows : 



59 



35 



17 



crop 





FET address 



error flagtttt 



Value of the operating system error flag at the time of the 
interrupt (refer to appendix E for a list of error flags). 



tThe MODE macro, described in section 6, can be used to specify which types of 
arithmetic operations will cause this error to be detected. 
ttNOS will allow a job to reprieve an operator KILL only once; the second time the 
operator KILLs the job, no reprieve processing will occur. 
tttRefer to Control of Program Execution in section 12 for a description of the methods 

by which you can interrupt a program from a terminal. 
ttftBecause the binary values of the error flags are subject to change in subsequent 

releases of NOS, you are encouraged to use the error class and error code fields for 
checking error status rather than the error flag field, 
ttttt If this field is nonzero, the FET involved has been left in a busy state. If the 
program wishes to use this FET within the interrupt handler (prior to doing a 
REPRIEVE RESUME), it is the program's responsibility to set the FET complete before 
trying to use it. 
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reserved This area is reserved for use by the installation. 



J-LLO U • 



exchange A copy of the exchange package at the time of the interrupt 

package (unchanged from the executing package at the time of the 

error). This is the exchange package that is used when the 

interrupt handler is started. 

Table 10-1 lists the return information for RPV error codes, classes, and flags. 
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Table 10-1. RPV Error Codes, Classes, and Flags 



Error 
Code(s) 


Description 


Error 
Class 


Corresponding 
Error Flags 





Normal termination 


100 


None 


1 


Time limit 


004 


TLET 


2 


CPU error exitt 


001 


ARET, PEET, PSET 


3 


PP abort, SCP invalid 








transfer address 


020 


PPET, Mt£T, ITET 


4 


CPU abort 


040 


CPET 


5 


PP call error 


002 


PCET 


6 


Operator drop 


010 


ODET, IDET, STET 


7 


Operator kill 


010 


SSET, 0KET, ORET, 
SYET, FSET 


10 


Operator rerun 


010 


RRET 


11 


Command error 


040 


None 


12 


Extended memory parity error 


020 


ECET 


15 


Auto recall error 


002 


None 


16 


Job hung in auto recall 


002 


RCET 


17 


Mass storage/ service limits 


004 


FI£T, TKET, SLET 


20 


PP program not in library 


002 


None 


21 


I/O limits 


004 


SRET 


34-37 


Reserved for installations 


N/A 


None 


40 


Terminal interrupttt 


200 


TIET, TAET 


N/A 


Reserved for installations 


2000 


None 


N/A 


Reserved for installations 


4000 


None 


N/A 


N/A 


N/A 


DRET, TJET, RAET 


tThe MODE macro 


, described in section 6, can be us 


ed to specif 


y which types of arithmetic 


operations wil 


1 cause this error to be detected. 






tt Refer to Contr 


ol of Program Execution in section 


12 for a des 


cription of the methods by 


which you can 


interrupt a program from a terminal 







Refer to appendix E for a complete list of error flags and descriptions. 
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REPRIEVE 

The REPRIEVE macro provides access to the extended reprieve processing capabilities of RPV. 
REPRIEVE parameters are inserted into the designated positions in the parameter block. 
Other fields are the responsibility of the caller. 






Location Operation 

REPRIEVE 



Variable 



addr ,type ,mask 



addr Address of the parameter block, 

type 



Type of call: SETUP, RESET, RESUME (program mode), or IRESUME (interrupt 
handier mode) . 



mask 



Desired mask setting. 



The REPRIEVE macro issues the RA+1 request without using common deck COMCSYS, since that 
routine is not reentrant and the interrupt could have occurred there. The interrupt handler 
should not access any other portions of the program which are not reentrant or are shared 
with noninterrupt handler code. 

One way to avoid this problem is to qualify those macro calls in the interrupt handler that 
use COMCSYS to issue the requests, and also provide a qualified copy of COMCSYS to ensure 
that no conflict exists. The following example illustrates this process with the MESSAGE 
macro. 

Inter ript handler code 



QUAL IHX 

MESSAGE ERR1,3 
QUAL * 



ERR1 DATA C*S0ME ERROR* 

QUAL IHX 

8UAL$ SET FORCE UNQUALIFIED COMMON DECKS 

OPL XTEXT COMCSYS 

QUAL * 



Appendix M contains an illustration of extended reprieve processing. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix F) . 
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SYSTEM/ LOADER REQUESTS 1 ] 



SYSTEM REQUEST: 



The following requests perform miscellaneous tasks associated with a job. Most of the 
requests are processed by the system monitor directly rather than by a specific function 
processor. The calling format is shown for each macro. Unless otherwise noted, the only 
common deck required for absolute assemblies is COMCSYS. 



ABORT 

A user program can abort itself when a program error occurs by using the ABORT macro. If 
the job or the current procedure contains an EXIT command, the system continues job 
processing with the command that immediately follows the EXIT command. This process can be 
altered either by reprieve processing (refer to section 10) or by using the NOEXIT command 
(refer to Volume 3, System Commands). 

Macro format: 

Location Operation Variable 
ABORT 

The format of the RA+1 call for this function is: 

59 35 



RA + 1 



ABTP 



DAYFILE 

The DAYFILE macro enables the user program to access the job dayfile. A FET of at least 
seven words must be specified. 

A portion of the dayfile resides in the system central memory buffers. This is transferred 
to the buffer in the job's field length specified by the FET pointers FIRST and LIMIT. You 
must ensure that the buffer specified is large enough to accommodate the central memory 
portion of the dayfile. The released size is 114g; if the value is different at your 
site , you should contact your site personnel to determine what it is . 

That portion of the dayfile that resides on mass storage is made available to the user 
program as a library file assigned to the job in read-only mode. If a local file with the 
same name as the file name specified already exists, it is returned. The file is positioned 
at BOI. 
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This macro requires common decks COMCSFM and COMSSFM for both relocatable and absolute 
assemblies and also requires common deck COMCSYS for absolute assemblies. 

Macro format :T 



Location Operation Variable 

DAYFILE addr, type 



addr 



type 



Address of the FET for the call; name given to the mass storage portion 
of the file. 

USER (function 0005); attach dayfile. This is the dayfile of the job 
currently running. 



The DAYFILE macro issues the following request to the function processor SFM. 



59 



RA + 1 



40 35 



SFM 



a^ 



23 17 



0005 



id 



oddr 



u 



R Auto recall bit (required), 

id File identification number . 

addr Address of the FET for the file. 

The format of the FET used by SFM is: 





59 47 44 23 


17 


FET +0 


Ifn 


W////////////A 


+ 1 


* mmw//////M - 


first 


+ 2 





in 


+ 3 





out 


+ 4 


^mm^m^^M^ 


limit 


+ 5 


i^^mm^M^mmm^ 


+ 6 


%M^M^^m^^^m%? 


*7 


^^^^mm^^^m^ 



TThe macro is not available in SYSTEXT. The user program must specify system text PSSTEXT 
or call common deck COMCMAC (refer to appendix F) . 
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lfn Local file name of the file to which the job dayfile is to be returned. 

dt Device type of the device on which the local file resides (refer to 
Equipment Codes in appendix E) . 

ep Error processing bit (refer to FET Description in section 2) . 

leu Specifies th© length of the FET beyond five words s 

first First word address of input/output buffer (FIRST address). 

in The next available location for entering data into the buffer (IN 
address). 

out The next available location for removing data from the buffer (OUT 
address). 

limit Last word address of the buffer plus 1 (LIMIT address). 

The IN and OUT FET pointers are updated after this request to indicate the presence of data 
in the buffer. 
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The following example reads the user dayflle and writes It to OUTPUT (assembly of this 
program requires that the system OPL be attached to the job). 



OPL 

** 

CBUFL 

BUFL 

WBUFL 



I 
SCR 


OUTPUT 

WDCT 



DAYF 



DAY1 
DAY2 



DAY3 

* 
DAY4 

DAY5 



IDENT OAYF 
ENTRY DAYF 
SYS CON B1 
XTEXT COHSSFM 

ASSEMBLY CONSTANTS-. 

EQU 400B 

EQU 301B 
EQU 300B 

FETS AND CONSTANTS. 



CM BUFFER LENGTH 

DAY FILE/OUTPUT BUFFER LENGTH 

WORKING BUFFER LENGTH 



BSS DAYFILE 

FILEB IBUF,BUFL,FET=7 

BSS OUTPUT 

FILEB OBUF,BUFL,FET=7 



WORD COUNT OF CH BUFFER 



DATA 

MAIN PROGRAM. 

S81 1 

DAYFILE I,USER 

SAVE CM BUFFER PORTION OF DAYFILE. 

SA1 1+1 COMPUTE CM BUFFER WORD COUNT 

SA2 A1+1 

SX1 X1 

1X6 X2-X1 

ZR X6,DAY1 IF CH BUFFER EMPTY 

SA6 UDCT 

READW I,CBUF,X6 READ CH BUFFER 

TRANSFER MASS STORAGE PORTION OF DAYFILE. 

READ I INITIATE FILE READ 

READW I,WBUF,WBUFL 

NZ X1,DAY3 IF TRANSFER COMPLETE 

WRITEW 0,WBUF / WBUFL CONTINUE TRANSFER 



EQ 



DAY2 



SX2 B6-WBUF 

ZR X2 # DAY4 

WRITEW 0,UBUF,X2 



SET WORDS TRANSFERRED 
IF NONE 
EMPTY BUFFER 



WRITE CH BUFFER PORTION OF DAYFILE. 



SA2 WDCT 

ZR X2,DAY5 

WRITEW 0,CBUF,X2 

WRITER 
RETURN I 
ENOHUH 



GET CM BUFFER WORD COUNT 
IF CH BUFFER EMPTY 
WRITE CH BUFFER 



OPL 

** 

IBUF 
OBUF 
CBUF 
WBUF 



COMMON DECXS. 

XTEXT COMCSFH 

BUFFERS. 

BSS BUFL 

BSS BUFL 

BSS CBUFL 

BSS WBUFL 



DAYFILE BUFFER 
OUTPUT BUFFER 
CM BUFFER 
WORKING BUFFER 



END 



DAYF 
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ENDRUN 

The ENDRUN macro requests normal termination of a program. The system begins execution with 
the next conmaixi. if there is one. If there are no more commands or if the next command is 
an EXIT command, the system terminates the job. This process can be altered by reprieve 
processing (refer to section 10). 



Macro format : 

Location Operation Variable 

ENDRUN 
The format of the RA+1 call for this function is: 



59 



35 



RA+1 



ENDP 






GETLIDA 

The GETLIDA macro allows the user program to obtain the various attributes for a specified 
LID. Common decks COMSSFM and COMCSFM are required for absolute and relocatable assemblies, 



Macro format :t 



Location 



Operation 



Variable 



GETLIDA addr 

addr Address to receive attributes of specified LID. 

The format for the RA+1 call for this function is: 

5§ 36 35 24 23 1817 



SFMP 



0030 



addr 



The format of addr word (before the call to COMCSFM) is: 
59 4241 



lid 





1 



lid 



User-specified lid. 



tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix F). 
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The attributes of the lid are returned in the following format: 

59 4241 3029 242 3 20 1817 109 

addr 



lid 


attr 





rfu 


nw 


re 


1 



lid 
attr 



rfu 



User-specified lid . 

lid attributes (zero if lid not found). 

Bit( s) Description 

41 Set if host lid. 

40 Set if linked lid. 

39 Set if lid is enabled. 

38 Set if prevalidation is required for lid. 

37 Set if store and forward lid on host. 

36 Set if store and forward lid on linked mainframe, 

35 Set if loopback lid on host. 

34-32 Reserved for CDC. 

31-30 Reserved for installation. 



Be served for CDC. 
Network enabled flags. 
Bit(s) 



Description 



20 Set if Scope 2 station is in service. 

19 Set if Remote Host Facility is in service. 

18 Set if Network Host Products is in service. 

SFM response code (zero if normal termination). 
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GETMC 

The GETMC macro allows the user program to obtain information about machine characteristics 
and the system environment. Common deck COMCCVL is required for absolute and relocatable 
assemblies . 



Location 



Operation 



GETMC 



Variable 



addr 



addr Address to receive machine characteristics. 

The format of the RA+1 call for this function is: 

59 35 

RA+1 



CVLP 



17 



0002 



addr 



TThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F) . 
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The machine characteristics are returned in the following format. 



addr 



59 






47 




35 




23 




!1 







W/a 


W/, 


c 


em 


PP 


mc 


cm 


c 



em 

PP 
mc 



If bit 48 is set, system is operating in 64-charactar set mode. 
If bit 48 is clear, system is operating in 63-character set mode. 
Extended memory size/ IOOO3. 
Number of PPs in system. 
Machine characteristics. 
Bit(s) 



23-22 
21 
20 

19-18 

17 
16 

15 
14 

13 
12 



Description 

Unused. 

Set if extended memory is in ESM mode. 

Set if machine is a CYBER 180-class model or models 865 

or 875. 

Knr,. rc-r-r, <f PH! 4 t, i ™ ,~A f»1 I 7t . ,„,-„ 1t PUTT -S = «» <- n 

model 176. 

2x PP speed. 

Set if machine is CYBER 170, except CYBER 180-class 

models . 

Set if compare move unit (CMU) option is present. 

Always set to indicate that CEJ/MEJ instruction is 

available. 

Set if CPUO has instruction stack. 

Set if CP01 is present. 



cm Central memory size/200g (set to 37778 if central memory>262K) . 

c Completion bit (set when operation complete). 

GETSSM 

The GETSSM macro allows the user program to determine if the system is running in a secured 
mode. 

Macro format :t 

Location Operation Var iabl e 

GETSSM addr 

addr Address to receive system security mode. 



tlhis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F) . 
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The system security mode is returned as follows: 
59 



•Mr 



ssm 



1 



Description 

If System is in unsecured mode. 
If System is in secured mode. 



11 



MEMORY 

The MEMORY macro enables you to determine or change the amount of central memory or extended 
memory associated with your job or determine the maximum amount of memory you can request. 



Macro format: 



Location 



Operation 



MEMORY 



Variable 



type , stat ,R, f 1 ,na 



type CM or null for central memory; either is legal. ECS for extended memory. 

stat Status word address. May be omitted only if the fl parameter is 
specified and na is null. 

R Auto recall bit. 

fl Desired new field length which, if specified, overrides the stat word. 

T£ JC1 J- -J£J-1 ..!_-. \TI7UADV _,..*-»a n *» »- n «-Ua ..«%«%n-^ QA K-t*-£ « F t-llA ^ +■ •> *" 

j.i. i.i is B^JcCii-XCU, I.L1C rli^i'iufXJ. uiav.i.t-' acus lilc u^pct **u wj.*-& vj- i.ih- oi-wt 

word to the value of fl. A negative value may not be used for fl. 

If the value of fl is greater than 377777s, the value must be passed 
to the MEMORY macro in an X register. 

na If null, the program is aborted if the request exceeds the current 
maximum which you are allowed. If this parameter is specified, the 
program is not aborted if the request exceeds the current maximum. 
Instead, the macro does not change the field length, and sets the stat 
word as defined below. 



The format of stat word (if used) is: 



59 



29 



stat 



vol 



3 



rsc 
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val 



Prior to the macro call, val is used to specify the desired new field 
length (words parameter can override this value). If val (or fl) is +0 
then the current field length for the specified type is returned in this 
field. If bit 47 of val is set and specified type is CM, and memory 
reduction is honored even if no reduce has been selected (that is, no 
reduce override is in effect). t If val is -1, then the current maximum 
field length for the specified type is returned; if user ECS is disabled 
or not present, a value of zero is returned in val, regardless of any 
validated extended memory field length. If val (or fl) is greater than 
zero for the macro call, it contains the actual value assigned upon 
return. If val is -0 and type is extended memory, the field length is 
set to 0. 



rs These bits are reserved for system usage. 

c Completion bit. The system sets this bit when the request is complete. 

If a request is given for an amount greater than the current maximum field length (refer to 
the NOS 2 Installation Handbook for a description of the current maximum field length) and 
if na is specified, then no field length change occurs and control is returned with val set 
to the current field length value. 

If the reserved bits (rs) in the status word are used, the MEMORY request or a subsequent 
MEMORY request may be aborted. 

The format of the RAH call for this function is: 



59 



RA+1 



RFL 



40 35 



17 



stat 



Alternate call format :tt 
59 



RA+1 



40 



MEM 



M 



17 



ttflt 



MESSAGE 

The MESSAGE function allows the user program to display a message on the system console 
display and enter it in a dayfile. 

If the job is of system origin, including a dollar sign as the first character of the 
message and routing the message with option 2 causes the message to be flashed on the B 
display. 

The maximum length of a message is 80 characters; up to 40 characters per line are 
displayed. The message ends with either the first word containing 12 bits of zeros in any 
byte or at the 80th character. Before issuing the MESSAGE function, the user program must 
pack the display coded message in sequential locations, beginning at location addr. 

The format of the RA+1 call for this function is: 



59 



RA+1 



MSG 



1 



40 



35 



23 



17 



oddr 



_tRefer to the REDUCE (-) command in the CYBER Loader Version 1 Reference Manual. 
TTTo maintain compatibility with N0S/BE. 
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Macro format: 

Location Operation Variable 



MESSAGE addr.x.R 

addr Beginning address of the message. The beginning address of the message 
cannot be within five words of the end of the iob's field !sn cr th. 

x Message routing option. 

x=0 Message is placed in the system dayf ile , the user 

dayfile, and job message buffer 1. 
x=l Message is placed in job message buffer 1. 
x=2 Message is placed in job message buffer 2. 
x=3 Message is placed in the user dayfile and displayed at 

line 1 of the control point. 
x=4 Message is placed in the user dayfile. 
x=5 Message is placed in the user dayfile. 
x=6 Message is placed in the system dayfile , the user 

dayfile, and job message buffer 1. 
x=7 Message is placed in the user dayfile and job message 

buffer l.t 

If x is not specified, x=0 is assumed. If x is not defined or is an 

incorrect positive value, x=l is assumed. If x is a negative number, 

unpredictable results will occur. If x is the character string LOCAL, 
x=3 is used. 

The job message buffers (1 and 2) allow you to display concurrently 
messages that enter the dayfile and those that require operator action. 
Message buffer 1 is normally used to display information about the 
current status of the executing program; for example: 

SKIPPING Ifn 

COPYING Lfn 

ASSEMBLING TEST 



Message buffer 2 is used by the system to issue error messages and 
warnings, and can be used by applications programs for the same 
purpose. Messages such as the following should be placed in message 
buffer 2: 

BUFFER OVERFLOW, FILE Lfn 

FILE Lfn NOT IN QUEUE 

TIME LIMIT, REPRIEVE INITIATED 

Message buffer 1 has a length of 50 characters (5 CM words); message 
buffer 2 has a length of 30 characters (3 CM words). 



f Provided for compatibility with NOS/BE. 
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These message buffers are displayed at the system console and can be 
displayed by user jobs using the ENQUIRE command. If there are messages 
in both buffers, the message in message buffer 2 is displayed; the 
message in message buffer 1 is displayed only if message buffer 2 is 
empty (contains binary zero). 

The contents of the job message buffer(s) are displayed when you enter 
the immediate job status command cE from an interactive terminal (refer 
to section 8 of Volume 3, System Commands), and when you enter the 
ENQUIRE, UJN or ENQUIRE, JSN=jsn command to determine the status of one of 
your jobs. 

Only messages that are of interest to other than the job, such as the 
commands processed and compilers used, should be placed in the system 
dayfile (x=0). All messages of interest to the job, such as the path 
taken by the programs and the number of records copied, should be placed 
only in the user dayfile (x=3). All messages placed in the user dayfile 
(x=0 and x=3) are counted by the system. If the number of messages 
issued by the job exceeds the limit for which you are validated, the job 
aborts . 

R Auto recall bit. 

If the MSG RAM request is i** R usd di^scfy ^no*" nsir*'* **v»g mac'c— a-d — — u^^e* ^ k-**-- .->* 
the location specified by the message address are zero, then bits 47 through 30 of this 
location are assumed to contain the beginning address of the message. This indirect 
addressing method is not supported by the macro call and unpredictable results will occur if 
it is attempted. 

MOVE 

The MOVE macro moves a block of data from addri to addr2. This macro requires the 
common deck COHCMVE for absolute assemblies. 

Macro format: 

Location Operation Variable 

MOVE count , add r j > add r 2 

count Number of words in the block to be moved, 
addri Address of the first word of the block to be moved. 
addr2 Address of the first word of the destination. 
MOVE allows overlap in data moves; that is, addr£ can be less than addrl plus count. 

RECALL 

The RECALL macro enables the user program to relinquish the CPU until a function is 
completed or the CPU recall time has elapsed (delay time is set by the installation, usually 
24 milliseconds). If the stat parameter is included in the call, control is not returned to 
the program until bit of the word specified by stat is set. If stat is not included in 
the macro call, the program relinquishes the CPU until the delay time expires, or until a PP 
activity completes. 
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Macro format: 



Location Operation 



RECALL 



Variable 



stat 



stat 



If this parameter is present, control is returned to the program when 
bit of the word specified by the address stat is set. This is usually 
the address of a FET. 



The format of the RA+1 call for this function is: 
59 40 



RA+1 



RCL 



0" 



17 



stat 



The auto recall bit, R, is set only if the stat parameter is specified. 



SUBR 

The SUBR macro enables the user program to distinguish between entering a subroutine and 
exiting from a subroutine even though control is transferred to the same address. Transfers 
to the subroutine are of the form: 

RJ tag 
Exits from the subroutine are of the form: 

EQ tagX 
Macro format :t 



Location Operation 
tag SUBR 



Variable 



SYSTEM 

With the SYSTEM function, the user program can request the system to process any 
three-character request. Refer to Request Processors, section 1, for a list of request 
processors. A PP program can be called from a CPU program if the first character of the 
name is alphabetic. Documentation of these programs (refer to the DOCMENT command in Volume 
3, System Commands) should be consulted for the functions available (for example, LFM, 
CPM). These should be used when macros do not exist to issue the functions desired. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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Macro format: 



Location 



Operation 
SYSTEM 



Variable 



req,R,p 1 ,p 2 



req 
R 

PI 
P2 



Three-character system request. 

Sets the auto recall bit for the request. If specified, control is 
returned only after the request is completed. If = is specified, no 
executable code is generated, but cross-references are made. 

Bits 17 through of the request. 

Bits 35 through 18 of the request. 



The format of the RA+1 call is: 
59 40 



RA+1 



req 



fe 



35 



17 



P2 



Example 1: 

A CIO function request can be issued with the following SYSTEM request: 

SYSTEM CIO,R,addr,n 

where addr is the address of the FET for the file being read and n is the count for skip 
operations. If R is specified, the request is made with auto recall. When performing a 
CIO request in this manner, the user program must set the function code in FET+0. 

Example 2: 

The following shows the correct use of the = parameter: 

SYSTEM XYZ,= 

Routine XYZ will not actually be called, but the symbol XYZ will' be created and KRONREF 
will recognize that this program calls XYZ. 
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WAIT 

The WAIT macro enables the user program to relinquish the CPU and remain in recall until a 
-r^v.^.i^.,.^ «^w u=.j.c»j, uj-uic iuu ciaiiacu. j.nc uciaj time can range rrotn tne system default 
recall time (10 milliseconds is the released default value) to 4095 milliseconds. 



Location 



Operation 
WAIT 



Variable 



delay 



delay The length of time in milliseconds that the job will remain in recall 
(if a value greater than 4095 is specified, the system uses the value 
4095). 



The format of the RA+1 call for this function is: 

59 ■ 4140 

RA + 1 



11 



WCL t^ R l ~ n d^ 



Auto recall bit. 
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USER FIELD LENGTH DUMP REQUESTS 

The following requests enable you to transfer Information residing in your job's field 
length to a file. Common deck COMCSYS is required for absolute assembly of these requests. 
These requests can not be made from a program in which the SETSSM macro has been executed, 
or from a program that was loaded from an execute-only file. 

The SYSTEM macro is used to issue the user field length dump requests. Each type of request 
is identified by a three-character request code that appears as the first element in the 
variable field of the SYSTEM macro. 



DUMP EXTENDED MEMORY (DEP) 

This request dumps extended memory to file OUTPUT.t The format of the request is: 
SYSTEM DEP, R, addr 

R Auto recall bit. 

addr The address of a parameter word with the following format. 
59 47 23 



addr 



fwa 



Iwa 



fwa 



lwa 



The address of the first word to be dumped. If this 
parameter is not specified, the dump begins with the 
first word of your job's extended memory. 

The address of the last word to be dumped. This 
parameter must be specified. 



DUMP EXTENDED MEMORY WITH DISPLAY CODE (DED) 

This request dumps extended memory to file OUTPUT. The dump contains display code 
equivalents to the right of the octal word representations. The format of the request is: 

SYSTEM DED, R, addr 



R 
addr 



Auto recall bit. 

The address of a parameter word with the following format. 

59 47 23 

addr 






fwa 


Iwa 



fwa The address of the first word to be dumped. If this 
parameter is not specified, the dump begins with the 
first word of your job's extended memory. 

lwa The address of the last word to be dumped. This 
parameter must be specified. 

tlf the file OUTPUT is assigned to an interactive terminal, the dump is written to file 
ZZZDUMP instead of to OUTPUT. 
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BINARY DUMP OF CENTRAL MEMORY AND EXTENDED MEMORY (DMB) 

This request creates a machine-readable binary dump file of your job's exchange package, 
central memory, and extended memory on file ZZZZDMB. File ZZZZDMB is not rewound bef~r~ ~~ 
after the dump; if ZZZZDMB is assigned to your terminal before the dump, the system returns 
it and creates a mass storage file ZZZZDMB. Each DMB request creates one logical record on 
ZZZZDMB. The format of the request is: 



SYSTEM DMB,R,em,rn 



R Auto recall bit. 

em Determines whether the system dumps extended memory. If a nonzero 

integer is specified, the system dumps extended memory. If em is zero 
or omitted, the system dumps only the exchange package and central 
memory. 

m Identifies the record name on file ZZZZDMB to which the dump will be 
written, rn is optional, but if it is specified It must be an octal 
value from through 777777g. The system appends rn to the letter D 
to form a seven-character dump record name. If rn is greater than 
377777s, the job aborts after the dump completes. 

Each logical record of ZZZZDMB has the following format: 





59 






53 


47 




35 


17 








7700 


0016 











1 


dump record name 





2 


A 


yy/mm/dd. 


3 


A 


hh/mm/ss. 


4 










last system program called t 








5 





6 



















7 





10 


last system program called f 


! ! 
\t 
16 


i 








image of last command executed ff 






a 



prefix 
table 



tWord PGNR of the job communication area. 
IT Words CCDR of the job communication area. 
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59 



17 



dump record name 



59 



41 





59 






53 


47 




17 










ID 





5 


1 


version 


2 


version 


3 


A 


yy/mm/dd. 


4 


A 


hh/mm/ss. 


5 


machine characteristics 



ID table 





59 




47 




17 










XP 





32 8 


1 

20 


exchange package 


21 

30 


AO register 
A7 register 


31 


RA 


32 








RA+1 











59 




47 




17 








CM 





CM FL/100i 8 




1 
n 


central memory 



exchange 
package table 





59 




41 




17 








ECS 





EM FL/1000 8 


1 

m 


extended memory 



central memory 
table 



extended memory 
table (appears only 
if extended memory 
is requested) 



END 






m 
A 



Octal number of central memory words assigned to the job. 
Octal number of extended memory words assigned to the job. 
Space (display code value 55g). 



If an extended memory error occurs, the block in error will be filled with 400g words of 
the following format. 



59 



11 



ECSERROR 



Word number of the block in error (starting with 1). 
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DUMP CENTRAL MEMORY (DMP) 

This request dumps central memory of your job's exchange package to file OUTHJT.t The 

SYSTEM IMP.R.lwa.fwa 

K aUui icCai.1 uiLt 

lwa The address of the last word to be dumped. This parameter must be 

specified if fwa is specified. 

fwa The address of the first word to be dumped. If this parameter is not 

specified but lwa is specified, the dump begins with the first word of 
your job's central memory. 

If neither fwa nor lwa is specified, the dump includes the exchange package and 40g central 
memory locations before and after the progran address in the exchange package. If either 
fwa or lwa is nonnumeric, the request is processed as if neither parameter had been 
specified. 



DUMP CENTRAL MEMORY WITH DISPLAY CODE (DMD) 

This request dumps your job's central memory or exchange package to file OUTPUT. 1" The dump 
contains display code equivalents to the right of the octal word representations. The 
format of the request is as follows : 

SYSTEM DMD^.lwa.fwa 

R Auto recall bit . 

lwa The address of the last word to be dumped. This parameter must be 

specified if fwa is specified. 

fwa The address of the first word to be dumped. If this parameter is not 

specified but lwa is specified, the dump begins with the first word of 
your job's central memory. 

If neither fwa nor lwa is specified, the dump includes the exchange package and 40g central 
memory locations before and after the program address in the exchange package. If either 
fwa or lwa is nonnumeric, the request is processed as if neither parameter had been 
specified. 

QUEUE FILE MANAGER 

Queue file manager (QFM) performs functions associated with queue and dayfile protection. 
The majority of the QFM functions are for special system jobs; these functions are not 
discussed in this manual (refer to the NOS 2 Systems Programmer's Instant) since they are 
not available to the applications programmer. Functions available to the applications user 
allow a job to be rerun in the event of a system interrupt or a hardware failure. 



tlf the file OUTPUT is assigned to the terminal, the dump is written to file ZZZZEMP instead 
of to OUTHJT. 
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The format of the call to QFM Is: 

59 40 35 



RA+1 



23 



17 



QFM 



code 



addr 



R Auto recall bit . 

code Function code. 

addr Address of the request. 



RERUN (015) 

The RERUN macro sets the job rerun status, indicating that the job may be rerun in the event 
of system failure. All non inter active jobs are initially given rerun status. The RERUN 
macro has no effect if used from an interactive job. 

Macro format : t 



location 



Operation 
RERUN 



Variable 



NORERUN (016) 

The M5RERUN macro clears the job rerun status (initially enabled) and prevents a j ob from 
being rerun. With this macro the user program can specify when a job may be safely rerun. 
For example, if a job has just updated a critical data base, it is probably desirable not to 
rerun the job. The user program can use the NORERUN macro to prevent this. This macro 
affects noninter active jobs only. The NORERUN macro has no effect if used from an 
interactive job. 

Macro format:* 



Location 



Operation 
NORERUN 



Variable 



LOADER REQUESTS 

The system provides routines to aid you in loading overlays or capsules at specific points 
during program execution. The overlays or capsules can reside on files attached to your job 
or in system libraries. 



fThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). 
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OVERLAY 

The OVERLAY macro processes a system request to the LDR processor. LDR provides the ability 
•.o iOa» overlays to specxrieu areas Oi tue user program area* Depending on the parameters 
specified and the level of the overlay, control may or may not be returned to the calling 
program* 

The format of the RA+1 call for this function is:T 



59 



RA + 1 



40 



LOR 



a 



17 



addr 



ZD 



addr 



Auto recall bit. 



Address of the request. 



The load request consists of two to four words. The two- to four-word block must be defined 
by the user program for RA+1 calls, but is defined by the system when called from the 
OVERLAY macro (only two words used). 





59 


53 


47 




40 




35 


17 







oddr+O 




nam* 





+1 


levl 


Iev2 


n 





ulv 





• 


Iwa 


fwa 


+2 


ovlnomt 





+3 


cptnome 






name 
levl 
lev2 



e 

lwa 

fwa 

ovlname 

eptname 



Source of name depending on the u and n options. 

First overlay level. 

Second overlay level. 

Number of words in request-2 (bits 47-46). 

Load option (bit 42). 

Overlay flag (must be set to 1) (bit 41). 

Call completion flag (bit 36). 

Last word address available for load. 

The address at which the overlay is to be loaded. 

Name of overlay to be loaded (if n>l and u=l). 

Entry point name when loading multiple entry point overlay (if n=2 and 
u-1). 



tLDV is processed by the system as the LDR call. This is to provide compatibility with the 
common product set. 
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The operation performed depends on the value of u, n, fwa, levl, and lev2. 

1. If u=0, n is ignored and name is the name of the file containing the overlay (levl 
and lev2 are required). 

2. If u=l and n=0, name is the name of an entry point in an overlay from the system 
libraryt (levl and lev2 are ignored). 

3. If u=l and n^O, ovlname is the name of the overlay from the system libraryt (levl 
and lev2 are ignored). 

4. If u=l and n=2, eptname is the name of an entry point in an overlay from the system 
libraryt (levl and lev2 are ignored). 

5. If fwa=0, the overlay is loaded at the address specified by the overlay. Otherwise 
the overlay is loaded at fwa. 

6. If levl=lev2=0, the (0, overlay) control is transferred to the called overlay; 
otherwise, control Is returned to the caller with fwa replaced by the entry point 
address of the overlay. 

7. If e=l, control transfers to the specified entry point, eptname, in the overlay. 

Upon completion of the load, the following information is returned to the four-word block 
beginning at location addr: 

59 S3 47 17 O 

•dd>+0 
+1 
+2 
+3 

eptaddr Entry point address of the overlay; if n=2, eptaddr is the address of 
eptname. 



name 





levl 


Iev2 





eptaddr 


ovlname 





eptname 






Macro format: 
Location 



Operation 



Variable 



nam 
lev 

SYSTEM 
fwa 



OVERLAY nam,lev,SYSTEM,fwa 

Address of file name in L format (display code, left-justified). 

Level of overlay. If not specified, level 0,0 is assumed and control is 
automatically transferred to transfer address encountered on overlay 
load. (Usually specified on IDENT pseudoinstruction of ABS programs.) 
For overlay level (i,j), level is defined as: lev=i*100g+j. 

If SYSTEM is specified, file is loaded from system library and nam is 
name of overlay desired. 

If this parameter is specified, fwa Is the address where the overlay is 
to be loaded. The file is loaded at the address specified on the 
overlay if this parameter is not specified. 



Common decks required are C0MC0VL and COMCSYS. 



tThe overlay is loaded from a user global library set file if the main program was loaded 
from a user global library set file. 
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After the macro is processed, XI contains the address of the entry in the overlay. 
Example 1 : 



OVERLAY TEST 



TEST CON 4LTEST 



This sequence of code loads overlay (0,0) from file name TEST and begins execution at 
the entry address specified by TEST. 



Example 2: 



OVERLAY A,0100B,S,LDA 
SB2 X1 
JP B2 



CON 5LARITH 



LDA EQU 



This sequence of code loads the ARITH routine from the system, level (1,0) library at 
address IDA and transfers control to the routine. 

J.J. Llie Lei{UCBL ^aiiD lUi L.iic. uvaiajf lu Dc lOaucu CU.1U uctULCU <uiu 11O iwa xOclu dUUJ.eo5 19 

specified in the request, the entry point address specified in the load table is used as the 
entry point address. If an fwa load address is specified in the request, bias the entry 
point address from the load table with the difference of the fwa load address specified by 
the request and the fwa load address specified by the load table; that is: 

Entry point address = (entry point address from load table) + (fwa load address 

specified in the request) - (fwa load address from load table) 

If the request requires just an overlay load, the entry point address returned is the entry 
point address in the load table. 



NOTE 



Overlay loads from an execute-only file are 
always allowed in the case of a (0,0) 
overlay. For any other overlay, a load from 
an execute-only file is only allowed if the 
original (0,0) overlay was loaded from the 
same file. 
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LOADD 

The LOADD macro allows the user program to locate procedures or fast dynamic load (FDL) 
capsules and have pertinent Information returned to a specified address. Fast dynamic 
loading is a method of loading preprocessed binary routines. 

The format of the RA+1 call for this function is: 



RA + 1 



59 


40 


17 


LDD ' ^R 


addr 



R Auto recall bit. 
addr Address of parameter block. 
The parameter block consists of two words in the following format. 





59 




47 




29 




7 




8 





addr+ 


group name 


stat 


fc 


+ 1 







liblist 


dlrlen 




directory 





group name Name of the group of capsules or procedures for which a directory is 
requested. 



stat 



fc 



Status of call (ignored during request). Upon completion of call, stat 
is set to one of the following values. 

Value Description 

Function completion without error. 

1 Illegal function code. 

2 Bad directory address or length (address plus length must be 
less than or equal to field length). 

3 Bad liblist address or length. 

The following errors may be combined with those preceding: 

108 An entry in the library list did not correspond to any known 
local or system library name, or an entry specified the name 
of file which was not a mass storage library. 

20g The specified directory space was not large enough to 
contain the entire directory. 

Function code. LDD sets bit to one when the request is complete: 

Specifies capsule (record type CAP). 
404g Specifies procedure (record type PROC). 
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llblist Address of a list of libraries to be searched after the global library 
set. Zero if no set is specified. 

dirlen Length, in central memory words, of the area to receive the generated 

directory. Upon completion of the call, it is set to the actual length 
that was needed for the complete directory (may be less than or equal to 
the value of the original call). 

directory Address of the area to receive the generated directory. 

When called, LDD searches first the global library set (refer to the CYBER Loader Version 1 
Reference Manual for a description of global library sets) and then the library set 
specified in the call. If a library file is found to contain one or more capsules belonging 
to the given group or the specified procedure, an entry is made in the directory. This 
entry is one of two different forms, depending on whether the library is a system library or 
a local file library. For a procedure, LDD searches the central library directory (CLD) if 
the specified procedure is not found elsewhere. 

For a local file library the format is: 



59 



17 



local file name f 



For a system library the format is: 



59 




47 




23 17 







I 7777 
I 





libord 1 

1 








libord 



The library ordinal of the library containing the capsule. 



For each capsule or procedure found that belongs to the given group, LDD makes the following 
entry in the directory. 



59 


56 






35 




17 







name 


faddr 


',* 


caddr 


daddr 


length 



faddr Address, relative to the beginning of the directory, of the word 

containing the file entry associated with this capsule or procedure. 

r Residence of capsule or procedure: 




1 
2 



Mass storage. 

Mass storage and CM. 

Mass storage and extended memory. 



1*The first character of the local file name must not be numeric. 
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caddr CM or extended memory address of capsule or procedure. 

daddr Disk address (relative PRD) of capsule or procedure. 

length Length of the capsule or procedure, including header, code Image, and 

relocation and linking information, but excluding the prefix table. 



Macro format :t 



Location 



Operation 



LOADD 



Variable 



addr.R 



addr Address of parameter block. 

R Auto recall bit. 

LOADQ 

The LOADQ macro loads fast dynamic load (FDL) capsules from specified files. 
The format of the RA.+1 call for this function is: 



59 



40 



RA+1 



LOO 



ffi 



17 



addr 



R Auto recall bit. 

addr Address of parameter block. 

The four-word parameter block must be defined as follows : 





59 17 B 


addr 40 


flit nam* 


ttat j fc 


+1 


group name 


W////////////, 


+2 


captult nan* 


fwa 


+ 3 


random address 


lwa+1 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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file name 
stat 



fc 



group name 

capsule name 

fwa 

random 
address 

lwa+1 



Name of file containing capsule. 

Status of LDQ call (ignored during request). Upon completion of 
call, stat is set to one of the following values. 

Value Description 

Function completion without error. 

1 Illegal function code. 

2 Bad address (must have fwa<lwa+l<field length). 

3 Nonexistent file or file not on mass storage. 

4 Bad disk address (out of file bounds). 

5 Capsule not found at specified location. 

6 Insufficient space provided for capsule. 

If either error 5 or 6 occurs , the contents of the loadable area are 
undefined . 

Function code: 

Load capsule. 

LDQ sets bit zero to one when the request is complete. 

Name of capsule group. 

Name of desired capsule. 

First word address of the area into which the capsule is to be read. 

Location of capsule on specified file. 

Last word address plus 1 of area for capsule. 



LDQ reads a capsule from the specified mass storage location, removing the prefix table, but 
not altering the record otherwise. LDQ ensures that the location contains a capsule (60 
table). LDQ also determines that the entire capsule fits into the specified area and that 
the name is correct. 
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Macro format : t 



Location Operation 
LOADQ 



Variable 



addr,R 



addr Address of parameter block. 
R Auto recall. 



MEMORY ALLOCATION FOR OVERLAY LOADERS 

The overlay loaders load records into central memory. If a record begins with an overlay 
table (50g-, 5I3-, and 53g-identification word), it is loaded according to the 
relative address given in the table (figure 11-1). The beginning load address must be 
greater than 110 g . For a 50g single entry point overlay, loading starts at origin minus 
one; for a 51g multiple entry point overlay, loading starts at origin minus wc minus one, 
where wc is the number of entry points. 



field length 




50, 51, Of 53 loader tool* 



absolute data 




first word loaded 


origin 




end-of 


-record 



Figure 11-1. Absolute Loader Memory Assignment 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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INTERACTIVE TERMINAL REQUESTS 

The following requests perform functions associated with control of your interactive 
terminal. The calling format is shown for each macro. 



NOTE 



The macros described in this section are 
intended for use by interactive origin jobs 
only. The use of these macros by other job 
origins will be ignored . 



DISTC MACRO t 



The DISTC macro enables an interactive program to prevent IAF from processing terminal 
control keys and commands , 

Capabilities similar to those provided by DISTC are available via reprieve processing (refer 
to Reprieve Processing, section 10). Because reprieve processing provides extended 
features, it should be used instead of DISTC. 

Macro format :tt 



Location 



st 



Operation 



Variable 



DISTC st,addr,INT 

Control status : 



ON 

OFF 



Activates program terminal control. 
Deactivates program terminal control . 



addr Specifies an interrupt address which the system uses to inform the 

program that a terminal operator attempted to interrupt or terminate the 
program. This parameter is valid only if st=0N. If addr is not 
specified, the program is not notified of attempted terminal control. 

INT If INT is specified when terminal control is attempted, the system 

copies the program operating registers (exchange package)ttt to the 
203-word area starting at addr. The program address is changed to 
addr+20s (that is, execution continues at addr+20g). If INT is not 
specified, the contents of addr are determined by the type of user break 
attempted: if user break 1, the contents of addr are set to 1. If user 
break 2, the contents of addr are set to 2. The program can check the 
location periodically to determine If the terminal operator has 
attempted to interrupt or terminate the program. 



tThis macro will be deleted in a future version of NOS. Extended reprieve processing 
(refer to the REPRIEVE macro in section 10) should be used instead of DISTC. 
TtThis macro is not available In SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck CGMCMAC (refer to appendix F) . 
tffA system request, XJR, allows the user program to restore the operating registers and 
resume normal processing after the Interrupt processing has been completed. 
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The interrupt address remains the same after the program is notified of an attempted 
interrupt. Oa.ce a terminal control is set or cleared, that status remains in effect until: 

• The program issues a DISTC macro that changes the status. 

• The program terminates, which returns the terminal to command mode. 

• You log off or disconnect the terminal. If the terminal was disconnected, you may 
recover. If the executing program is continued after recovery, the terminal control 
status remains as it was prior to the disconnect. If the executing program is not 
continued, the interrupt address is cleared. 

The following is a list of terminal control sequences and their effect when you select the 
disable terminal control feature (the @ denotes the message terminator key). 



Phase 

Waiting 
for input 



Generating 
output 



Executing 



Sequencet 

CTRL/T @ 

or 
CTRL/P ® 



BREAK 
CTRL/T© 

or 
BREAK 
CTRL/P @ 



CTRL/T @ 

or 
CTRL/P @ 



Effect 

You may enter this sequence at the beginning of any input 
line unless transparent input mode has been selected. 
If an interrupt address was specified, the program is 
notified of attempted control. 

If an interrupt address was specified, the program is 
notified of attempted control. When the BREAK key is 
pressed, output is suspended. However, unless CTRL/T @or 
CTRL/P @ is entered next, the program is not notified of 
an attempted terminal control . 

If any other sequence is entered, or if just a @ is 
entered, the program is not notified of terminal control 
and the output operation continues. 

If an interrupt address was specified, the program is 
notified of attempted control. 



NOTE 



If either REPRIEVE or EREXIT are present in 
the same routine with a DISTC call, they will 
take precedence over the DISTC call , and the 
DISTC will have no effect. 



TThe termination (sometimes referred to as user break 2) sequence (that is, CTRL/T®) and 
interruption (sometimes referred to as user break 1) sequence (that is, CTRL/P®) may vary 
for different terminals. Befer to Volune 3, System Commands, for further information. 
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CSET MACRO 

The CSET macro sets the initial and current character set mode of the terminal to either 
ASCII or NORMAL. 

Macro format :t 



Location 



Operation 



Variable 



CSET 



mode,C 



mode ASCII Set ASCII 128-character set mode. 

NORMAL Set ASCII graphic 63/64-character set mode. 
RESTORE Set current terminal character mode to initial terminal 
character mode. 

C Change initial and current terminal character mode to that specified; if 
C is omitted, only the current mode is changed. 



NOTE 



The use of this macro may cause the character 
mode of the terminal to switch prior to the 
printing of all previous output. This can be 
prevented by preceding the macro call with an 
input request with recall or with a rollout 
request , or by flushing the output buffer 
with a WRITER or WRITEF request. 



PROMPT MACRO 

The PROMPT macro enables or disables the issuing of the terminal input prompt (a question 
mark). The input prompt is turned on at the beginning of each job step. 

Macro format :f 



Location Operation 



Variable 



PROMPT 



mode 



mode 



Input prompt mode desired: 



ON Terminal input is requested with a question mark. 

OFF No terminal input prompt is issued. 



TThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F) . 



60459690 B 



11-31 



SETSLM MACRO 

The SETSLM macro returns or sets the display mode of the interactive terminal associated 
with a j ob . 



Macro format :t 



Location Operation 



SETSLM 



Var iabl e 



addr ,W 



addr Address of parameter word. 

W If present, the terminal's display mode is set according to the values 

specified in the parameter word. If omitted, the terminal's current 
display mode is returned to the parameter word. 



Parameter word format: 



59 



addr 



6 5 



status 



status Terminal display mode status 

Bit(s) 



0-5 



Description 
Terminal model ordinal. 
Ordinal Mnemonic tt 



Terminal Type 






None 


Any terminal that does not 
support screen mode . 


1 


N/A 


Reserved for CDC. 


2 


721 


CDC 721. 


3 


722 


CDC 722. 


4 


VT100 


DECttt VT100. 


5 


Z19 


Zenith Z19ttt or 
Heathkit H19.ttt 



Terminal display mode. 
Value Description 



Screen mode , 
Line mode. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC. 
ttThese mnemonics and their corresponding ordinals are defined in common deck C0MCGT0. 
tttDEC is a registered trademark of Digital Equipment Corporation. The Zenith Z19 is a 

product of Zenith Radio Corporation. The Heathkit H19 is a product of the Heath Company. 
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tcthtiic utran 

The TSTATUS macro returns the status of the terminal. Information returned includes 
terminal type, subsystem being used, the terminal number, parity, character set information, 
duplex and tape mode status , and the current interrupt address . 

Ma/»-m fnrmaf-'t 



Location 



Operation 



TSTATUS 



Variable 



addr 



addr 
Status block format 

addr + 

+ 1 



Address of two-word status block. 



59 


53 


47 


43 


35 




17 


11 







tid 


tys 


In 





cs 





te 


int 


Iran 


ft 



tid 



sys 



tn 



Left-justified, blank-filled display code terminal type identification: 
Type Description 
NAMIAF Interactive terminal (only terminal type returned). 
Subsystem ordinal: 



Ordinal 


Description 





Null subsystem. 


1 


BASIC subsystem. 


2 


FORTRAN subsystem 


3 


FTNTS subsystem. 


4 


Execute subsystem 


5 


Batch subsystem. 


6 


Access subsystem. 



Terminal number (octal). 
Connection status. 



Value 
(octal) 



1 

2 
3-13 
14-17 



Description 

Not interactive. 

Detached • 

Online. 

Reserved for CDC. 

Reserved for installation. 



tThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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tc Terminal class: 



Class 




(octal) 


Description 


1 


M33, M35, M37, or M38 TTY 


2 


CDC 713-10, 722, 751-1, 752, 756 


3 


CDC 721 


4 


IBMt 2741 


5 


M40 TTY 


6 


Hazel tine 2000 


7 


DECt VT100 


10 


Tektronix 4010, 4014 


11 


HASP Protocol (postprint format control) 


12 


200 User Terminal 


13 


CDC 714-30 


14 


CDC 711-10 


15 


CDC 714-10/20 


16 


HASP Protocol (preprint format control) 


17 


CDC 731-12, 732-12 


20 


IBM 2780 


21 


IBM 3780 


22 


IBM 3270 



I 

I 

int Current interrupt address if specified on DISTC macro; if INT is also 

specified on the DISTC macro , bit 35 is set. 

tran Transmission code: 

Code Description 

3 Interactive terminal (only code returned) . 

st Terminal status bits: 

Bit Description 

Reserved. 

1 Initial character set (ASCII if set). 

2 Current character set (ASCII if set). 

3 lie served. 

4 Reserved. 



tDEC is a registered trademark of the Digital Equipment Corporation. IBM is a registered 
trademark of International Business Machines. 
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EFFECT MACRO 



The HFFECT macro allows the user program to control the formatting of terminal output, 

Torn 4« al 



DfiT!!! si "1 " oAnfi-Al ^ gA K*» TAP* * 



must supply all formatting for terminal output • 



jjj- *J($i. aui 



Control bytes 0001, 0002, 0003, 0013, 0014, and 0015 should not be used while the mode Is 
set to OFF, since use of these bytes may result in the loss of control over the carriage. 
This macro effects only terminals connected to the system by way of NAM. 



Macro format: 



Location 



Operation 



Var iabl e 



EFFECT 



mode 



mode ON IAF controls all formatting of terminal output. 

OFF USER program controls all formatting of terminal output, 

omitted IAF controls all formatting of terminal output. 



NOTE 



For a list of format effectors and a 
discussion of the effect on a specific 
terminal class, refer to the NAM Version 
1/CCP Version 3 Terminal Interface Raference 
Manual. 
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PROGRAM WRITING TECHNIQUES 1 2 



WRiTiNG PROGRAMS UNDER N05 

Listings of programs that use the macros and common decks described in this manual can serve 
as an aid to understanding many of the features described in this manual. For example, to 
obtain a listing of the COPYC program, enter the following commands after accessing the 
system OPL.t 

MODI FY,LO=E,Z . /*EDIT,COPYC 
COMPA$S,I,L=l-ist,S=NOSTEXT,B=0. 
ROUTE, Ust,DC=LP. 

If you follow the documentation standards described in appendix I, you can use the 
documentation utilities to document your program. These specifications are supplied as a 
guide to enable you to understand the format of system programs and to give you an idea of 
how to structure programs. 

You should organize the program area, buffers, and working storage areas in a manner that 
uses the least amount of memory for the shortest period of time. This provides better 
performance and more efficient use of system resources. Areas of code that are used once, 
such as preset routines, should be overlayed with buffers that are used later in the 
program. All main programs should be set to load past location 110s since areas before 
this address contain program and system parameters. ft If a program has several entry 
points, the origin should be higher. Placing FETs , table pointers, and other critical data 
areas at the beginning of the program aids in debugging because these areas do not change 
addresses as code in the program is changed. 



PARAMETER PROCESSING 

When a program is initiated, the command parameters are stored in the job communication area 
(refer to figure E-l) beginning at ARGR (RA+2) through RA+n (n cannot exceed 633). These 
parameters are terminated by a zero word. The number of parameters stored in the job 
communication area is placed in the lower 18 bits of ACTR (RA+64g). The name of the 
command is placed in bits 59 through 18 of PGNR (RA+64g). The parameters are stored in 
either operating system or product set format. The command image, less any label or prefix 
field, is stored beginning at CGDR (KA+70g). 

If the parameters are stored in operating system format, the comma, period, and right 
parenthesis are stored as zero. For all parameters and valid separators except the comma, 
their display code equivalent is stored. 



TYour site must control access to the system OPL as required by the site's licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the 
system OPL. 
tt Refer to appendix E. 
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If the parameters are stored in product set format, separators and terminators are stored as 
follows: 



Character 


Code (Octal) 


> 


1 


= 


2 


/ 


3 


( 


4 


+ 


5 


- 


6 


5 


10 


) or . 


17 


Others 


16 



Parameters for user programs are normally stored in product set format. You can force 
operating system format in either of two ways: 

• Prefix the command with a slash (/). 

• For programs loaded from a global library set, include an NPC= entry point in the 
program. 

Example : 

When a program is loaded from a local file with the following command: 

TEST,A=B,C=D,E,F. 

the command parameters are stored in product set format and the contents of central 
memory are as follows: 

ARGR RA+2 0100 0000 0000 0000 0002 

+3 0200 0000 0000 0000 0001 

+4 0300 0000 0000 0000 0002 

+5 0400 0000 0000 0000 0001 

+6 0500 0000 0000 0000 0001 

+7 0600 0000 0000 0000 0017 

+10 0000 0000 0000 0000 0000 



CCDR RA+70 2405 2324 5601 5402 5603 TEST,A=B,C 
RA+71 5404 5605 5606 5700 0000 =D,E,F. 
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A 


B 


B 


A 


C 


B 





A 


E 


A 


F 






If the command is changed to: 

/TEST,A=B,C=D,E,F. 

the command parameters are stored In operating system format and the contents of 

locations RA+2 through RA+10g appear as follows: 

ARGR RA+2 0100 0000 0000 0000 0054 A = 

+3 0200 0000 0000 0000 0000 B 

+4 0300 0000 0000 0000 0054 C = 

+5 0400 0000 0000 0000 0000 D 

+6 0500 0000 0000 0000 0000 E 

+7 0600 0000 0000 0000 0000 F 

+10 0000 0000 0000 0000 0000 



NOTE 



If you are using the common deck COMCARG 
(refer to appendix F) for argument 
processing, you do not need to be concerned 
with the different formats, since COMCARG 
processes both formats correctly. 
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WRITING INTERACTIVE PROGRAMS 

You may choose to write interactive programs in languages other than those oriented 
specifically to the terminal (for example, COMPASS). You can also convert some batch 
application programs to interactive programs. The following description of system 
conventions acquaints the user with potential problem areas in performing this conversion or 
in writing interactive programs. 



CONVERSION PROBLEMS 

The major difference between an interactive job and a batch job is in the handling of files 
assigned to a terminal. Since the system is designed with a common control interface to all 
types of equipment, the applications programmer need not be concerned about the specific 
piece of equipment with which the program is communicating. 

Certain problems arise when application programs not written with terminal interaction in 
mind are converted to interactive programs. These problems are: 

• Each line of terminal input is considered a logical record. This causes two basic 
problems . 

First, any program that terminates input processing on an EOR processes only 
one line of input. 

Second, programs that read ahead on input place a special significance on an 
EOR, and therefore cannot effectively interact while accepting these 
one-line records. This problem is minimized by the design of NOS 
input/output. However, when the problem does occur, it is fatal to program 
execution. 

• Many programs output more than 72 characters per line. This may result in 
unacceptable output; however, this is easily corrected by using the L072 command or 
by reformatting the output in the program. 

• Many programs perform unnecessary write requests on output. This can cause high 
system overhead. 

Portions of the NOS standard product set are modified to correct these problems. 



DEFAULT FILE ASSIGNMENTS AND SPECIAL FILE TREATMENT 

All jobs interacting with your terminal have the INPUT and OUTPUT files assigned to the 
terminal unless you or a program assigns them to a different device. You can assign a file 
to the terminal by assigning a file to equipment TT using the ASSIGN command; you can assign 
the INPUT or OUTPUT file to mass storage by specifying a device type of MS on the ASSIGN 
command. A user program can make similar assignments with the REQUEST macro. 

Normally, an interactive program need not check for EOI on INPUT; however, you must ensure 
that INPUT is checked for EOI file status if INPUT might be assigned to mass storage. 
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SPECIAL HANDLING 

When a program makes a read request with recall on a terminal input file, the circular 
buffer of a ter&iinaj. xij.e can uc autoniaticajLj.y nusucd *,as if an EOR write had been 
performed) before the system issues the read request. 

A program can use one of the following methods to ensure that output data is sent to the 
terminal in this way. 

• The program can specify a list of files (refer to the SETLOF macro, section 6) from 
which the system determines the appropriate file name. This is the preferred method, 

• The program can store FET pointers, which specify the files to be flushed, in RA+2 
through KA4638. The FET pointer is the file name left- justified with zero-fill in 
bits 59 through 18 and the address of the FET in bits 17 through 0. 

In using the first method, the system checks only the first file in the list. This file 
must meet the following criteria. 

• The file must either be assigned to the terminal (device type equals TT in the FET) 
or, if unassigned, must be named OUTPUT. 

• The file must meet the conditions described under the flush bit (refer to 
description of the flush bit, FET description, in section 2). 

In using the second method, the system uses the first file that meets the preceding criteria. 



OTHER SPECIAL HANDLING 

The following additional considerations apply to the execution of interactive programs. 

• An EOR or EOF write on a terminal file has no special significance except that it 
ensures that the buffer is dumped to the terminal . 

• When terminal input data is passed to an executing program, the following convention 
is followed . 

If the input data consists of data followed by a carriage return, the system 
supplies an EOR level of one (level number is in bits 17 through 14 of FET+0) . 
If there is no data input but only a carriage return, the system supplies an EOF. 

A program can process input from a terminal properly by sensing an EOR level of 
1. The system input/output macros and common decks (except the READO macro) are 
coded to handle this case properly. Mast of the system utilities interact with 
a terminal in this manner . 

Input from a terminal is handled in the same manner as the CIO READSKP request. 
If the program's buffer is not large enough to accommodate a full line of input, 
the data is truncated and the excess is lost. No error code is returned. 
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• 



A program that is interacting with a terminal should not do a recall on a file 
assigned to a terminal if it does an EOR or EOF write on the file to clear the 
buffer (do not specify the r option on WRITER or WRITEF macros). If recall is 
specified, an extra rollout of the program may be required before the program 
terminates. If the conventions mentioned earlier concerning the status of output 
are followed, it is not mandatory to write an EOR or EOF to clear the buffer; 
however, if it is done without auto recall (to remain compatible for batch use, for 
example) as the last operation before the ENDRUN macro, little additional system 
overhead is incurred. 

If the conventions for special handling are followed, a job being rolled out by the 
system has all completed lines of data in the output buffer sent to the terminal. 

If a program aborts because an error occurs, the contents of the first message 
buffer of the control point area are sent to the terminal as part of the output. 
Messages can be placed in this area using the MESSAGE macro. Messages longer than 
48 characters are truncated to 48 characters. If you are in the batch subsystem, 
this message buffer is always sent to your terminal at the end of each job step, 
except for job steps that are within a procedure file. 

If a buffer argument error is detected on an output buffer when output is being 
issued automatically, the output is ignored and the FET is not acted on. This error 
usually indicates that the executing program has destroyed part of its own field 
length . 

• A COMPASS program can determine whether it is interacting with a terminal input or 
output file by checking the type of equipment to which the file was assigned (byte 
zero of FET+1). Refer to the common deck COMCSTF, appendix F. 



PROGRAM CONTROL OF TERMINAL ACTIVITY 

The remainder of this section describes methods of controlling terminal activity when 
connected to the Interactive Facility (IAF). 

You can control terminal activity in the following ways. 

• Include control bytes in your program output to control the positioning of the 
printing element and define alternate input modes. 

• Enter various characters or sequences of characters to control program execution. 

• Issue a REPRIEVE macro (refer to section 10) to disable the terminal operator's 
control of the user program during various phases of execution. 

• Issue a CSET macro to change the character set of the terminal. 

• Issue a PROMPT macro to control the issuing of the input prompt . 

• Issue a TSTATUS macro to determine certain terminal characteristics. 

• Issue an EFFECT macro to control the formatting of your terminal output . 
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CONTROL BYTES 

A control byte is a 12-bit quantity, right -justified in bit position 0, 12, 24, 36, or 48 of 
a CM word • 



NOTE 



You must ensure that data is not mistaken 
for a control byte. For example, in the 
64-character set, the characters :D at the 
beginning of a line and followed by an 
end -of -line will cause you to be logged off 
if they are written to the terminal output 
file, since the code 0004 is transmitted. 



The following paragraphs describe the bytes available to a user program and their functions. 
Symbols for most of these control bytes are defined in the system OPL common deck COMSTCM, 
and may be used by COMPASS programs. 



0000— End-of-Line 

End-of-line generates a carriage return and line feed, positioning the terminal printing 
element at the beginning of the next line. An end-of-line consists of 12 to 66 bits of 
zero, right-justified in one or two central memory words. 



000 1 , 0002— End-of-Block 

This byte prevents the positioning of the terminal printing element at the beginning of the 
next line. An end-of -block byte can be used to allow the terminal user to enter input on 
the same line as the input request is printed. This byte must be followed by an 
end-of-line. If not followed immediately by a read request, any output following this byte 
may be lost. 



0003— Auto Input 

This byte is used by IAF for auto mode input. The preceding characters in the line in which 
this byte occurs are sent to the terminal and are also retained as the first characters of 
the input line. The network can retain a maximum of 20 characters. This byte must be 
followed by an end-of-line. The next terminal operation must be an input request. The 
terminal prompt (a question mark) is suppressed. 

Refer to Volume 3, System Commands, for further information about auto mode input. 



NOTE 



The 0003 control byte cannot be used in 
conjunction with transparent output. 
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0004— Log Off User 

This byte disconnects the terminal from IAF and the network. This byte must be the first 
byte of a line and must be followed by an end-of-line. 



0005— Initiate ASCII Input 

This byte causes the next line of input to be translated into 6/12 display code. The 
terminal prompt (a question mark) is suppressed. This byte must be followed by an 
end-of-line. On the subsequent input, all terminal control characters or sequences (refer 
to Control of Program Execution in this section) and terminal definition commands are 
processed as they are for normal input mode unless the SE terminal definition command has 
been entered (refer to Volume 3, System Commands). End-of-line (normally a carriage return) 
terminates 0005 input mode. 

If input has been typed ahead when this byte is issued, that input is translated in the old 
mode . 



0006 — Initiate Transparent Input Mode 

This byte changes the input mode from normal or ASCII to transparent mode. The terminal 
prompt (a question mark) is suppressed. The byte must be byte of the first word of a line 
and the word must be terminated by an end-of-line. Bytes 1 and 2 are defined as follows: 

Byte 1 Specifies the maximum number of characters (up to 7777s) to De received 

before input is terminated. If byte 1 is 0, the number is assumed to be 1. 

Byte 2 Specifies the termination code. When a character is received from the 

terminal that matches this byte, the input operation is terminated. 
Depending on the parity specified for the terminal connection, the lower 8 
bits of byte 2 are matched against all 8 bits of the input character, or the 
lower 7 bits of byte 2 are matched against the lower 7 bits of the input 
character. If bit 11 of this byte is set, no termination character is 
assumed .t 

This conversion mode packs each 8 bits of data as the lower 8 bits of a 12-bit byte and sets 
the upper bit (bit 11). The exhaustion of the character count or the occurrence of the 
termination code causes the end-of-line condition to be set. A 0007 byte is forced as the 
first byte of input so the data is transmitted as transparent output if it is listed. 

A user selected input prompt should follow the 0006 word if it is necessary to guarantee 
that the terminal is in transparent input mode before input is entered. For example, the 
following two words, when written to an ASCII-code terminal output file, switch the terminal 
to transparent input mode and issue three BEL characters (ASCII code 007) at which point 
transparent input mode is in effect. 

If input has been typed ahead when this byte is issued, that input is translated in the old 
mode. 



tFor more information on parity options, refer to the NAM Version 1/CCP Version 3 Terminal 
Interface Reference Manual. 
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0006 


0012 


0015 


0000 


0000 


0007 


4007 


4007 


4007 


0000 



Byte 1 of the 0006 word specifies a maximum character count of 10 U2g) and byte 2 
specifies a termination character of carriage return (015g ASCII code). Refer to the 
description of the 0007 control byte for the second word. 



NOTE 



The use of transparent input with CYBER 
Record Manager and/or product set utilities 
(including compilers) may yield 
unpredictable results. It is advisable to 
determine how a particular product set 
member treats transparent input before 
proceeding. For example, to initiate 
Transparent Input from a FORTRAN 5 program, 
refer to appendix F of the FORTRAN Version 5 
Reference Manual for additional information. 



0007 — Initiate Transparent Output 

This byte initiates transparent output. If you wish to output data formatted as described 
for transparent input, a 0007 byte must precede the data. This mode continues until an 
end-of-line or nontransparent output data byte is detected. Termination by an end-of-line, 
however, does not cause a carriage return and line feed. The 0007 byte must be byte (bits 
59 through 48) of the first word of a line. 

A transparent output data byte is in the format 4xxxg, where xxx is the 8-bit octal code 
for the character being printed. Bits 11 through 8 of a transparent output data byte are 

original (normal or ASCII) output mode; this feature can be used to output normal or ASCII 
data immediately following transparent data without explicitly specifying a termination 
(end-of-line). The characters 5, 6, 7, and 8 (display codes 40g, 41g, 42g, and 43g) 
match the transparent mode bit pattern when in the upper half of a byte and are interpreted 
as transparent data. Therefore, these characters cannot be used to terminate transparent 
output. Once transparent output mode is terminated, it remains cleared unless resumed by a 
0007 control byte. 

The following word, when output from an ASCII-code terminal, produces a line feed and prints 
a question mark. There is no carriage return or line feed after the question mark. 

0007 4012 4077 0000 0000 

The 4012 byte produces a line feed (012 is the ASCII code for line feed) and 4077 is the 
question mark. The transparent output is terminated by the 24 bits of trailing zeros, 
constituting an end-of-line. Similar output can be obtained with the following: 

0007 4012 7100 0000 0000 

Here 71 is the display code for a question mark and 7100 is a nontransparent data byte. 
Transparent output is terminated at the question mark and the end-of-line produces a 
carriage return and line feed. 
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A control byte that changes the terminal input mode (0003, 0005, or 0006) prevents the 
system from printing a question mark in response to a program request for input. However, 
in all other cases, a read request on the input buffer causes the system to print a question 
mark at the terminal (unless the program has issued a PROMPT OFF macro). 



NOTE 



The use of transparent output with CYBER 
Record Manager and/or product set utilities 
(including compilers) may yield 
unpredictable results. It is advisable to 
determine how a particular product set 
member treats transparent output before 
proceeding. For example, to initiate 
Transparent Output from a FORTRAN 5 program, 
refer to appendix F of the FORTRAN Version 5 
Reference Manual for additional information. 
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0010 — Reserved 

This byte should not be used. 

001 1— Initiate ASCII Output 

This byte is used to initiate 128-character ASCII output (6/12 display code). This byte 
must be byte (bits 59 through 48) and applies only to the line currently being output. 

0012 — Reserved 

This byte should not be used. 



0013— End-of-String 

This byte allows a user to terminate a line of output data without repositioning the 
terminal carriage. This byte must be followed by an end-of-line (which is ignored) and 
output continues with subsequent data. The 0013 byte should not be used where the effect of 
an end-of-line is needed (for example, the end of a logical line on a synchronous terminal). 



0014— Internal End-of -Block 

This byte is the first byte of a word and is followed by an end-of-line. This byte is 
reserved by N0S and should not be used since it may cause loss of data. 



0015 — Executive Auto Input 

This byte is used for internal auto input mode. It is reserved by N0S and should not be 
used since it may cause loss of data. 



0016 — Terminal Redefinition 

This byte enables you to alter the characteristics of a terminal that is connected via IAF. 
The byte begins a string of 12-bit parameter/ 12-bit value pairs. The upper bit of each 
12-bit segment must be set to prevent a zero value from being interpreted as an 
end-of-line. The 0016 byte string must be terminated by an end-of-line. 

Table 12-1 lists parameters and values allowed for each set of terminal classes. For 
default values for each terminal class, refer to Volume 3, System Commands. Refer to 
appendix A for the translation of ASCII characters. 
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Table 12-1. Terminal Redefinition Parameters (Sheet 1 of 4) 



Parameter (Miemonic) 



Abort block (AB) 



Blocking factor (BF) 



Break as user break 1 (BR) 



Backspace character (BS) 



Interruption character (Bl) 



Termination character (B2) 



Carriage return idle count 
(CI) 



Cancel character (CN) 



Cursor positioning (CP) 



Network control character 
(CT) 

Single message transparent 
input delimiters (DL) © 



Number 
(Octal) 



Terminal 
Classes Q) 



Value 

Range 

(Decimal) 



51 

31 

63 

47 

52 

53 

54 
56 
46 

107 

50 
70 

71 
72 
73 



1 - 8 (9 - 18)© 



- 8, 10 - 13, 15 
9, 14, 16, 18) 

- 3, 5 - 8 
A, 9 - 17) 

- 8 (9 - 18) 



- 15 (16, 18) 

- 15 (16, 18) 

- 8 (9 - 18) 

- 8 (9 - 18) 

- 15, 18 
16, 17) 

- 3, 5 - 8 
4,9- 18) 

- 18 

- 8 (9 - 18) 



- 3, 5 - 8 
9 - 18) 

- 3, 5 - 8 
9 - 18) 

- 8, 10 - 13, 

5 (9, 14, 16 - 18) 



- 127 

0-20 

- 1 

- 127 

- 127 

- 127 

0-99 

1 

- 127 

- 1 

- 127 

- 1 

0-15 
- 255 
0-255© 



Form of 
Input 



Numerical value for 
character © 

Decimal number 



Yes (1), no (0) 



Numerical value for 
character Q) 

Numerical value for 
character Q) 



Numerical y_alue for 
character 



s 3 



Decimal number 

CA (1) 

Numerical value for 
character @ 

Yes (1), no (0) 



Numerical value for 
character C2) 

Character specified 
(1), not specified 
(0) 

Character count 
(upper byte) 

Character count 
(upper byte) 

Numerical value for 
character (2) 



(D Numbers in parentheses in this column indicate terminal classes for which the parameter 

is ignored . 
(f) Ignored for packet-switching network (PSN) terminals. 

(3) Any hexadecimal value except 00 - 02, 20, 30 - 39, 3D, 41 - 5A, 61 - 7A, or 7F. 
© If the value of one of the fields for this parameter is changed, the values of all 

other fields for this parameter must also be specified. 
(5) Not all values are legal for all terminal classes. 



• 12-12 
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Table 12-1, Terminal Redefinition Parameters (Sheet 2 of 4) 



Par am eter ( Mnem cmic ) 



iMimoer 
(Octal) 



74 



lermxnai 
Classes © 



1 - 3, 5 - 8 
(9 - 18) 



106 II- 8, 10-13, 

| | 15 

End-of- block character (EB) ; 100 | 1 - 3, 5 - 8, 

I 10 - 13, 15 

! 101 I 1 - 3, 5 - 8, 

j | 10 - 13, 15 

| 102 I 1 - 3, 5 - 8, 

i 10 - 13, 15 

i i (9, 14, 16, 17) 



Value 

Range 

(Decimal) 



rorm ox 
Input 



End-of-line character (EL) ! 75 



1 - 3, 5 - 8, 
10 - 13, 15 



0-1 i Timeout (1) , no 

j timeout (0) 

j 

! Single message (0) 



I - 127 \£/ [Numerical value for 
I character © 

I ! 

I 1 - 2© |EL (1), EB (2) 

I | 

i - 3© JNO (0), CR (1), 
;LF (2), CL (3) 



- 12 7 W Numerical value for 



76 i 1 - 3, 5 - 8, 

I 10 - 13, 15 



1 - 2 



aerical vaj 
charac ter (5) 

|EL (1), EB (2) 



Echoplex mode (EP) 



Full ASCII input (FA) 

Host availability 
display (HD) 

incur control (IC) 



• Input device (IN) 



77 

61 

67 
41 



Tir>p ^ped 1dl= rinnf ( yT ^ 



64 
65 

57 



1 - 3, 5 - 8, 

1/1.11 !( 

(9, 14, 16 - 18) 

1-3, 5-8 
(4, 9 - 18)® 



1-8, 10-13, 15 - 1 



1 - 17 



'. - 3, 5 - 8 
(4, 9 - 18)® 

1-8, 10-13, 
15 



- 3 © jNO (0), CR (1), 



- 1 ;Yes (1), no (0) 

Yes (1) , no (0) 
0-1 Yes (1), no (0) 

0-1 Yes (1 ,i , no (0) 



1 - 8 



© 



0-1 i Transparent input 

(1), not transparent 
(0) 

- 2 © 'KB (0), PT (1), 
jBK (2) 



1 _ 9 fQ - 1 ft 1 



1 - 8 (9 - 18) 



A _ QQ 

1 



D£c is! si n imb st 
CA (1) 



© Numbers in parentheses in this colunn indicate terminal classes for which the parameter 

is ignored . 
© Not all values are legal for all terminal classes. 

§ Ignored for packet-switching network (PSN) terminals . 
Not allowed for packet-switching network (PSN) terminals. 
\jj BCLy nexaae<_liucii vailie except, uv — Ui, Zu, ju — jj, jli, <+i — 3A, Di — /A, or is. 
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Table 12-1. Terminal Redefinition Parameters (Sheet 3 of 4) 



Parameter (Mnemonic) 


Number 
(Octal) 


Terminal 
Classes ® 


Value 

Range 

(Decimal) 


Form of 
Input 


Lockout unsolicited 
messages (LK) 


40 


1 - 15, 18 
(16, 17) 


- 1 


Yes (1), no (0) 


Output control (OC) 


104 


1 - 3, 5 - 8 
(4, 9-18)© 


- 1 


Yes (1), no (0) 


Output device (OP) 


66 


1 - 8 (9 - 18) 


0-2® 


DI (0), PR (1), 
PT (2) 


Parity processing (PA) 


62 


1 - 3, 5 - 8 


0-4 


Z (0), (1), 

E (2), N (3), I (4) 


Page waiting (PG) 


45 


1 - 8, 10 - 13, 

15, 18 (9, 14, 

16, 17) 


- 1 


Yes (1), no (0) 


Page length (PL) 


44 


1-18 


0, 8 - 
255 © 


Decimal number 


Page width (PW) 


43 


1 - 18 


0, 20 - 
255 


Decimal number 


Special editing mode (SE) 


60 


1 - 8 (9 - 18) © 


- 1 


Yes (1), no (0) 


Terminal class (TC) 


42 


1 - 18 


1 - 18© 


Decimal number 


Multimessage transparent 
input delimiter (XL)© 


70 


1 - 8 (9 - 18) 


- 1 


Character specified 
(1), not specified 
(0) 




71 


1 - 3, 5 - 8 
(9 - 18) 


0-15 


Character count 
(upper byte) 




72 


1 - 3, 5 - 8 
(9 - 18) 


- 255 


Character count 
(lower byte) 




73 


1-8, 10 - 13, 15 
(9, 14, 16 - 18) 


- 255® 


Numerical value for 
character © 




74 


1 - 3, 5 - 8 
(9 - 18) 


- 1 


Timeout (1), no 
timeout (0) 


® Numbers in parentheses i 

is ignored. 
© Ignored for PSN terminal 
© Not all values are legal 
© Not allowed for PSN term 
© If the value for one of 

other fields for this pa 
(6) Any hexadecimal value ex 


n this cc 

s. 

for all 
inals . 
the field 
rameter u 
cept 00 - 


lumn indicate termir 

terminal classes. 

s for this parametei 

ust also be specific 

02, 20, 30 - 39, 31 


lal classes f 

■ is changed, 

.d. 

), 41 - 5A, 6 


or which the parameter 

the values of all 
1 - 7A, or 7F. 
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Table 12-1. Terminal Redefinition Parameters (Sheet 4 of 4) 



Parameter (Mnemonic) 


Number 
(Octal) 


Terminal 
Classes Q-) 


Value 

Range 

(Decimal) 


Form of 
Input 




105 


1 - 


8 (9 - 18) 


0-255© 


Numerical value for 
character © 




106 


1 - 


8, 10 - 13, 15 


1 


Multimessage (1) 


Transmission block size 


36 


1 - 


18© 


0-7 


Decimal number 
(upper byte) 




37 


1 - 


18 


- 255 


Decimal number 
(lower byte) 


Upline block limit 


30 


1 - 


18 


1 - 31© 


Decimal number 


Full duplex 


127 


1 - 
(4, 


3,5-8 
9 - 18) 


- 1 


Yes (1), no (0) 


(T) Numbers in Darentheses 


in this en 


lutnn 









parameter is ignored. 
© Not all values are legal for all terminal classes. 

© Any hexadecimal value except 00-02, 20, 30-39, 3D, 41 - 5A, 61 - 7A, or 7F. 
(4) Ignored for PSN terminals. 



Up to 18 terminal characteristic values can be changed by a single 0016 byte string. For 
example, to change the page width to 100 (144 8 ), control character to %, and turn the page 
wait option on, issue the following string. 



0016 4043 4144 4050 4045 4045 4001 
In the preceding example, each byte has the indicated meaning: 



0000 0000 0000 



0016 Terminal redefinition control byte. 

4043 Specifies page width parameter (43g). 

4144 Sets page width to 100 (144g). 

4050 Specifies control character parameter (50g). 

4045 Sets control character to % (45g). 

4045 Specifies page wait parameter (45g). 

4001 Sets page wait on (1 equals yes). 

00... 00 End-of-line (terminates terminal redefinition control byte). 

For a complete description of terminal characteristics, refer to Volume 3, System Commands. 
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CONTROL OF PROGRAM EXECUTION 

By entering various sequences of keys or commands at your terminal, you can control an 
interactive program during all phases of execution. The following is a list of the 
interruption and termination sequences and their effect on the executing program (the @ 
denotes the message terminator key). 

Phase Sequence T Effect 

* — —■ ~^^^— 

Waiting CTRL/T @ The program is terminated and the terminal is placed in 

for input command mode. All other entries are passed to the 

program as data. 

Generating BREAK Pressing the BREAK key on asynchronous terminals suspends 

output seq the output operation. For synchronous terminals, output 

is automatically suspended on page boundaries, at which 
point terminal control can be attempted. 



note! 



Cn asynchronous terminals , output can 
be suspended by pressing any key 
that transmits a character. The 
character entered is also sent to 
IAF if a @ or line feed is entered. 
The integrity of this character is 
not guaranteed, and may cause the 
interruption sequence which follows 
. to be ignored . It is recommended 
that the BREAK key be used to suspend 
output . 



TThe termination (sometimes referred to as user break 2) sequence (that is, CTRL/T®) and 
interruption (sometimes referred to as user break 1) sequence (that is, CTRL/P®) may vary 
for different terminals, and may be changed by terminal definition commands. Refer to 
Volume 3, System Commands, for further information. CTRL refers to the control key. 
Thus, CTRL/T is entered by keeping the control key depressed while pressing the T key. 
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Phase Sequence t Effect 

Once output is suspended, further execution depends upon 

«-*« 9MM ou ijuwu b os^u^uwd v*. kc jfo ul *_ lid i. a^. u; i. o cumcea ■ 

Each of the following sequences has the indicated effect 
on the output operation. 

seq Effect 

CTRL/T@ This has the same effect as the 

termination sequence in the input 
phase . 

CTRL/P@tt The output operation ceases and the 

terminal is placed In suspend mode. 
At this point IAF recognizes only: 

• The P key causing a return to 
program control, discarding 
any data In the program 
buffer prior to the 
interruption sequence . 

• A © causing output to be 
continued and program control 
to continue normally . 
Portions of the output may be 
lost when output is suspended. 

» Any other key (with the 

exception of terminal control 
characters and terminal 
definition commands) is 
interpreted as a request to 
terminate the job step. 

If any other sequence of characters or keys is entered 
followed by a @ , the output operation is resumed with 
the last partial line repeated. 

Executing CTRL/T© These have the same effect as if they were entered during 

or output phase. 

CTRL/P® 



tlhe termination (sometimes referred to as user break 2) sequence (that is, CTRL/T©) and 
interruption (sometimes referred to as user break 1) sequence (that is, CTRL/P©) may 
vary for different terminals and may be changed by terminal definition commands. Refer 
to Volvme 3, System Commands, for further information. CTRL refers to the control key. 
Thus , CTRL/T is entered by keeping the control key depressed while pressing the T key. 

ttlf the BR terminal redefinition parameter has been set to 1 or if the terminal definition 
command cBR=Y or TRMDEF,BR=Y has been entered, the BREAK key has the same effect as 
CTRL/P@. 
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REPRIEVE PROCESSING FOR USER BREAKS 1 AND 2 

If the user program has selected terminal Interrupt reprieve processing, control will be 
passed to the user's Interrupt package when a user break 1 or 2 is encountered. The user 
program may now process the interrupt as desired. 

To ignore either interrupt, a REPRIEVE RESUME call may be used. This will restart the 
interrupted sequence as If the interrupt had never occurred. 

If the user wishes to have the system process the user break 2, a REPRIEVE RESET call will 
return control to the system, and the interrupt will be processed in the normal manner. 

The user break 1 interrupt cannot be returned to the system by a RESET call. 

If the user desires the sequence 

♦INTERRUPTED* (CR) 

that is normally associated with a user break 1, the sequence will have to be emulated in 
the user's interrupt handler. 
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CHARACTER SETS 



A character set is cuuposed of graphic and control characters* A code set is a set of codes 
used to represent each character within a character set. 

A graphic character may be displayed at a terminal or printed by a line printer. Esamples 
are the characters A through Z and the digits through 9. A control character initiates, 
modifies, or stops a control operation. An example is the backspace character that moves 
the terminal carriage or cursor back one space. Although a control character is not a 
graphic character, a terminal may produce a graphic representation when it receives a 
control character. 

All references within this manual to the ASCII character set or the ASCII code set refer to 
the character set and code set defined in the American National Standard Code for 
Information Interchange (ASCII, AN3I Standard X3. 4-1977). References in this manual to the 
ASCII character set do not necessarily refer to the ASCII code set. 

NOS supports the following character sets. 

• CDC graphic 64- (or 63-) character set. 

• ASCII 128-character set. 

• ASCII graphic 64- (or 63-) character set. 

• ASCII graphic 95-character set. 

Each installation selects either the 64-character set or the 63-character set. The 
differences between the tw> are described in Character Set Anomalies in this appendix. Any 
reference in this appendix to the 64-character set implies either the 63- or 64-character 
set, unless otherwise stated. 

NOS supports the following code sets. 

• 6-bit display code. 

• 6/12-bit display code. 

• 7-bit ASCII code. 

Display code is a set of 6-bit codes from 00g to 77g. 

The 6/12-bit display code is a combination of 6-bit codes and 12-bit codes. The 6-bit codes 
are 00g through 77g, excluding 74g and 76g. (Refer to Character Set Anomalies for 
the interpretation of the OOg and 63g codes.) The 12-bit codes begin with either 74g 
or 76g and are followed by a 6-bit code. Tnus , 74g and 76g are considered escape 
codes and are never used as 6-bit codes within the 6/12-bit display code set. The 12-bit 
codes are 7401g, 7402g, 7404g, 7407g, and 7601g through 7677g. All other 12-bit 
codes (74xxg and 7600g) are undefined. 
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The 7-bit ASCII code (as defined by ANSI Standard X3. 4-1977) is right- justified in a 12-bit 
byte. Assuming that the bits are numbered from the right starting with 0, bits through 6 
contain the ASCII code, bits 7 through 10 contain zeros, and bit 11 distinguishes the 
OOOOg code from the end-of-line byte. The 7-bit codes are OOOlg through 0177g and 
4000 8 . 



CHARACTER SET ANOMALIES 

NOS interprets two codes differently when the installation selects the 63-character set 
rather than the 64-character set. In tables A-l, A-2, and A-3, the codes for the colon and 
percent graphic characters in the 64-character set are unshaded; the codes for the colon and 
percent graphic characters in the 63-character set are shaded. 

If an installation uses the 63-character set, the colon graphic character is always 
represented by a 63g code, and the OOg code is undefined. However, if the installation 
uses the 64-character set, output of 6/12-bit display codes 7404g or 6-bit display code 
OOg produces a colon. In ASCII mode for interactive jobs, a colon can be input only as a 
7404g 6/12-bit display code. 

When using either the 63- or 64-character set, the use of undefined 6/12-bit display codes 
in output files produces unpredictable results and should be avoided. 

On input, NOS recognizes alternate 029 punch codes of 11-0 for the right bracket (]) and 
12-0 for the left bracket ([)• The alternate codes support the COBOL sign overpunch 
convention and are not recommended for other uses. Refer to COBOL 5 Reference Manual. 

Also, two 00g codes may be confused with an end-of-line byte and should be avoided (refer 
to appendix F for further explanation) . 

Translation of 7-bit ASCII to 6-bit display code causes character set folding from the 
128-character ASCII set to the 63- or 64-character ASCII subset. The following special 
character substitutions occur: 

7-Bit ASCII 6-Bit Display Code 

Code Character Code Character 

0140 x 74 @ 

0173 { 61 [ 



7-Bit 


ASCII 


Code 


Character 


0100 


@ 


0133 


[ 


> 0134 


\ 


0135 


] 


0136 


- 



0174 | > 75 \ — 

0175 } 62 ] 

0176 - 76 " 



CHARACTER SET TABLES 

This appendix contains character set tables for interactive jobs, batch jobs, and jobs 

involving magnetic tapes. Table A-l is for interactive jobs, and table A-2 is for batch 

jobs. Table A-3 is a conversion table used to cross-reference 7-bit ASCII codes and 

6/12-bit display codes and to convert ASCII codes from octal to hexadecimal. 
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Tables A-4, A-5, and A-6 list the magnetic tape codes and their display code equivalents. 

The character set tables are designed so that you can find the character represented by a 

code (such as in a dimDl or find f-hp rcAe that rcn-ro cant a a ,,>,.».-..<,*.„_ tv» «j_j «-i 

character represented by a code, look up the code in the column listing the appropriate code 
set and then find the character on that line in the column listing the appropriate character 
set. lb find the code that represents a character, you first lookup the character and then 
rirsd crs cods on tlis 



INTERACTIVE JOBS 

Table A-l shows the character sets and code sets available to you at an ASCII code 
terminal. When in NORMAL mode (specified by the NORMAL command? ) , NOS displays the ASCII 
graphic 64-character set and interprets all Input and output as 6-bit display code. When in 
ASCII mode (specified by the ASCII command), NOS displays the ASCII 128-character set and 
interprets all Input and output as 6/12-bit display code. 

To determine the octal or hexadecimal ASCII code for a character, refer to table A-3. 
(Certain terminal definition commands require specification of an ASCII code.) 

On output, the US code is reserved for network use and defined as an end-of-line. Use of 
this character, except In transparent mode, causes incorrect formatting and possible loss of 
output characters. 



BATCH JOBS 

Table A-2 lists the CDC graphic 64-character set, the ASCII graphic 64-character set, and 
the ASCII graphic 95-character sets. It also lists the code sets and card punch codes (026 
and 029) that represent the characters. 

The 64-character sets use display code as their code set; the 95-character set uses 7-bit 
ASCII code. The 95-character set is composed of all the characters in the ASCII 
128-character set that can be printed at a line printer (refer to jobs using Line Printers). 
Only 7-bit ASCII code files can be printed using the ASCII graphic 95-character set. lb 
print a 6/12-bit display code file (usually created by an interactive job in ASCII mode), 
you must convert the file to 7-bit ASCII code. To do this, you enter the PCOPY command. 
The 95-character set is represented by 7-bit ASCII codes 0040g through 0176 8 . 



ttfomial and ASCII modes can also be selected via the CSET COMPASS 
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JOBS USING UNE PRINTERS 

The batch character set printed depends on the print train used on the line printer to which 
the file is sent (refer to section 7). The following are the print trains corresponding to 
each of the batch character sets. 

Character Set Print Train 



CDC graphic 64-charaeter set 596-1 

ASCII graphic 64-character set 596-5 

ASCII graphic 95-character set 596-6 

The characters of the default 596-1 print train are listed in the table A-2 column labeled 
CDC Graphic (64 Character); the 596-5 print train characters are listed in the table A-2 
column labeled ASCII Graphic (64 Character); and the 596-6 print train characters are listed 
in the table A-2 column labeled ASCII Graphic (95 Character). 

If a transmission error occurs when printing a line, the system prints the line again. The 
CDC graphic print train prints a concatenation symbol ( r-*) in the first printable column of 
the repeated listing of the line. The ASCII print trains print an underline (_) instead of 
the concatenation symbol. 

If an unprintable character exists in a line (that is, a 7-bit ASCII code outside the range 
0040g through 0176s), the number sign (#) appears in the first printable column of a 
print line, and a space replaces the unprintable character. 

To route and correctly print a 6/12-bit display code file on a line printer with the ASCII 
graphic 95-character set, you must convert the 6/12-bit display code file to a 7-bit ASCII 
code file with the FCOPY command (refer to section 9). The resulting 7-bit ASCII file can 
be routed to a line printer (refer to section 7) but cannot be output at an interactive 
terminal. 
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Table A-l. Character Sets for Interactive Jobs (Sheet 1 of 2} 









6/12- 










6/12- 




ASCII 


ASCII 


6-Bit 


Bit 


7-Bit 


ASCII 


ASCII 


6— Bit 


Eit 


7 13.* 


Graphic 


Character 


Display 


Display 


ASCII 


Graphic 


Character 


Display 


Display 


ASCII 


(64 Character) 


(128 Character) 


Code 


Code 


Code 


(64 Character) 


(128 Character) 


Code 


Code 


Code 


: colon 

- t- ■ » « 


,lrH,«l ,.««!« „.,!„, 


not 


SBHIB.B* 




# number sign 

[ opening bracket 


# number sign 

[ opening bracket 


60 
61 


60 
61 


0043 
0133 


iiH*?sti^£ 




e*t. 


A 


A 


01 


ui 


G101 


) closing bracket 


j closing bracket 


62 


62 


0135 


B 


B 


02 


02 


0102 


Z percent sign 


% percent sign 


63 


63t 


0045 


C 


C 


03 


03 


0103 


s . i«. 


*«.tom 


S3 


lltEff 


£}%&$&&*>&$ 


D 


D 


04 


04 


0104 


" quote 


" quote 


64 


64 


0042 


£ 


E 


05 


05 


0105 


__ underline 


__ underline 


65 


65 


0137 


F 


F 


06 


06 


0106 


! exclamation point 


! exclamation point 


66 


66 


0041 


G 


G 


07 


07 


0107 


& ampersand 


& ampersand 


67 


67 


0046 












apostrophe 


apostrophe 


70 


70 


0047 


H 


H 


10 


10 


0110 


? question mark 


? question mark 


71 


71 


0077 


I 


I 


11 


11 


0111 


< less than 


< less than 


72 


72 


0074 


J 


J 


• 12 


12 


0112 


> greater than 


> greater than 


73 


73 


0076 


K 


K 


13 


13 


0113 


@ commercial at 


@ commercial at 


74t 


7401 


0100 


L 


L 


14 


14 


0114 


\ reverse slant 


\ reverse slant 


75 


75 


0134 


M 


M 


15 


15 


0115 


circumflex 


circumflex 


76t 


7402 


0136 


N 


K 


16 


16 


0116 


; semicolon 


; semicolon 


77 


77 


0073 








17 


17 


0117 




: colon 




7404 


0072 


P 

Q 


P 

Q 


20 
21 


20 
21 


0120 

0121 


KsilllliSill^M 


grave accent 74 * 


mm 

7407 


IMlilHI 

0140 


K 


R 


22 


22 


0122 












S 


S 


23 


23 


0123 




a 




7601 


0141 


T 


T 


24 


24 


0124 




b 




7602 


0142 


U 


U 


25 


25 


0125 




c 




7603 


0143 


V 


V 


26 


26 


0126 




d 




7604 


0144 


W 


u 


27 


27 


0127 




e 
f 




7605 

7606 


0145 
0146 


X 


X 


30 


30 


0130 




g 




7607 


0147 


If 


Y 


31 


31 


0131 












Z 


Z 


32 


32 


0132 




h 




7610 


0150 








33 


33 


0060 




i j 


7611 


0151 


1 


1 


34 


34 


0061 




i 


7612 


0152 


2 


2 


35 


35 


0062 




k 




7613 


0153 


3 


3 


36 


36 


0063 




1 




7614 


0154 


4 


4 


37 


37 


0064 




m 
n 






7615 
7616 
7617 


0155 
0156 
0157 


5 


5 


40 


40 


0065 












6 


6 


41 


41 


0066 




P 




7620 


0160 


7 


7 


42 


42 


0067 




q 




7621 


0161 


8 


S 


43 


43 


0070 




r 




7622 


0162 


9 


9 


44 


44 


0071 




s 




7623 


0163 


+ plus 


+ plus 


45 


45 


0053 




t 




7624 


0164 


- dash 


- dash 


46 


46 


0055 




u 




7625 


0165 


* asterisk 


* asterisk 


47 


47 


0052 




V 

w 




7626 
7627 


0166 
0167 


/ slant 


/ slant 


50 


50 


0057 




X 




7630 


0170 


( opening parenthesis 


( opening parenthesis 


51 


51 


0050 




y 




7631 


0171 


) closing parenthesis 


) closing parenthesis 


52 


52 


0051 




z 




7632 


0172 


$ dollar sign 


$ dollar sign 


53 


53 


0044 




{ opening brace 


61 1 


7633 


0173 


= equal 


= equal 


54 


54 


0075 




1 vertical line 


75 t 


7634 


0174 


space 


space 


55 


55 


0040 




} closing brace 


62 1 


7635 


0175 


, comma 


, comma 


56 


56 


0054 




- tilde 


76 1 


7636 


0176 


. period 


. period 


57 


57 


0056 




DEL 




7637 


0177 


^The interpretation of 


this character or code 


may dept 


nd on it 


context. 


Refer to Character Set 


Anomalies elsewhere in this appendix. 
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Table A-l. Character Sets for Interactive Jobs (Sheet 2 of 2) 









6/12- 










6/12- 




ASCII 


ASCII 


6-Bit 


Bit 


7-Bit 


ASCII 


ASCII 


6-Bit 


Bit 


7-Bit 


Graphic 


Character 


Display 


Display 


ASCII 


Graphic 


Character 


Display 


Display 


ASCII 


(64 Character) 


(128 Character) 


Code 


Code 


Code 


(64 Character) 


(128 Character) 


Code 


Code 


Code 




NUL 




7640 


4000 




DLE 




7660 


0020 




SOH 




7641 


0001 




DC1 




7661 


0021 




STX 




7642 


0002 




DC2 




7662 


0022 




EIX 




7643 


0003 




DC3 




7663 


0023 




EOT 




7644 


0004 




DC4 




7664 


0024 




ENQ 




7645 


0005 




NAK 




7665 


0025 




ACK 




7646 


0006 




SYN 




7666 


0026 




BEL 




7647 


0007 




ETB 




7667 


0027 




BS 




7650 


0010 




CAN 




7670 


0030 




HI 




7651 


0011 




EM 




7671 


0031 




LF 




7652 


0012 




SUB 




7672 


0032 




VT 




7653 


0013 




ESC 




7673 


0033 




FF 




7654 


0014 




FS 




7674 


0034 




CR 




7655 


0015 




GS 




7675 


0035 




SO 




7656 


0016 




RS 




7676 


0036 




SI 




7657 


0017 




ust 




7677 


0037 


tReserved for network 


use. Refer to Character Set Tables in this appendix. 
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Table A-2. Character Sets for Batch Jobs (Sheet 1 of 3) 



CDC 


ASCII 


ASCII 


6-Bit 


6/ 12-Bit 


7-Bit 






Graphic 
(64 Character) 


Graphic 
(64 Character) 


Graphic 
(95 Character) 


Display 
Code 


Display 
Code 


ASCII 
Code 


runch Code 


026 


029 


: colont 


: colont 


WS - - MR; 4tk. a«X.«!S UViflV 


cot 


or^ 




8-2 


8-2 


A '"" ..»-■- 


Tr^ "* '" 


B 


B 


B 


02 


02 


0102 


12-2 


12-2 


C 


C 


C 


03 


03 


0103 


12-3 


12-3 


D 


D 


D 


04 


04 


0104 


12-4 


12-4 


E 


E 


E 


05 


05 


0105 


12-5 


12-5 


F 


F 


F 


06 


06 


0106 


12-6 


12-6 


G 


G 


G 


07 


07 


0107 


12-7 


12-7 


H 


H 


H 


10 


10 


0110 


12-8 


12-8 


I 


I 


I 


11 


11 


0111 


12-9 


12-9 


J 


J 


J 


12 


12 


0112 


11-1 


11-1 


K 


K 


K 


13 


13 


0113 


11-2 


11-2 


L 


L 


L 


14 


14 


0114 


11-3 


11-3 


M 


M 


M 


15 


15 


0115 


11-4 


11-4 


N 


N 


N 


16 


16 


0116 


11-5 


11-5 











17 


17 


0117 


11-6 


11-6 


P 


P 


P 


20 


20 


0120 


11-7 


11-7 


Q 


Q 


Q 


21 


21 


0121 


11-8 


11-8 


R 


R 


R 


22 


22 


0122 


11-9 


11-9 


S 


S 


S 


23 


23 


0123 


0-2 


0-2 | 


T 


T 


T 


24 


24 


0124 


0-3 


0-3 1 


U 


U 


U 


25 


25 


0125 


0-4 


0-4 i 


V 


V 


V 


26 


26 


0126 


0-5 


0-5 i 


W 


W 


W 


27 


27 


0127 


0-6 


0-6 


X 


X 


X 


30 


30 


0130 


0-7 


0-7 


Y 


Y 


Y 


31 


31 


0131 


0-8 


0-8 


Z 


Z 


Z 


32 


32 


0132 


0-9 


0-9 











33 


33 


0060 








1 


1 


1 


34 


34 


0061 


1 


1 


2 


2 


2 


35 


35 


0062 


2 


2 


3 


3 


3 


36 


36 


0063 


3 


3 


4 


4 


4 


37 


37 


0064 


4 


4 


5 


5 


5 


40 


40 


0065 


5 


5 


6 


6 


6 


41 


41 


0066 


6 


6 


7 


7 


7 


42 


42 


0067 


7 


7 


8 


8 


8 


43 


43 


0070 


8 


8 


9 


9 


9 


44 


44 


0071 


9 


9 


+ plus 


+ plus 


+ plus 


45 


45 


0053 


12 


12-8-6 


- dash 


- dash 


- dash 


46 


46 


0055 


11 


11 


* asterisk 


* asterisk 


* asterisk 


47 


47 


0052 


11-8-4 


11-8-4 


TThe interpretation 


of this character or 


;ode may depend on its 


context. 


Refer 


to Chara 


cter Set 


Anomalies 


elsewhere in this < 


appendix. 
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Table A-2. Character Sets for Batch Jobs (Sheet 2 of 3) 






CDC 


ASCII 


ASCII 


6-Bit 


6/12-Bit 


7-Bit 






Graphic 
(64 Character) 


Graphic 
(64 Character) 


Graphic 
(95 Character) 


Display 
Code 


Display 
Code 


ASCII 
Code 


Punch Code 


026 


029 


/ slant 


/ slant 


/ slant 


50 


50 


0057 


0-1 


0-1 


( opening parenthesis 


( opening parenthesis 


( opening parenthesis 


51 


51 


0050 


0-8-4 


12-8-5 


) closing parenthesis 


) closing parenthesis 


) closing parenthesis 


52 


52 


0051 


12-8-4 


11-8-5 


$ dollar sign 


$ dollar sign 


$ dollar sign 


53 


53 


0044 


11-8-3 


11-8-3 


» equal 


= equal 


= equal 


54 


54 


0075 


8-3 


8-6 


space 


space 


space 


55 


55 


0040 


no punch 


no punch 


, comma 


, comma 


, comma 


56 


56 


0054 


0-8-3 


0-8-3 


. period 


. period 


. period 


57 


57 


0056 


12-8-3 


12-8-3 


— e.quivalence 


# number sign 


# number sign 


60 


60 


0043 


0-8-6 


8-3 


[ opening bracket 


[ opening bracket 


[ opening bracket 


61 


61 


0133 


8-7 


12-8-2 t 


] closing bracket 


] closing bracket 


] closing bracket 


62 


62 


0135 


0-8-2 


11-8-2 t 


% percent signt 


% percent signt 


% percent sign? 


63t 


lot 


0045 


8-6 


0-8-4 


F not equal 


quote 


: colon 
quote 


« 


illlliii 

64 




iSr-j 


flf 


i» concatenation 


_ underline 


_ underline 


65 


65 


0137 


0-8-5 


0-8-5 


V logical OR 


! exclamation point 


! exclamation point 


66 


66 


0041 


11-0 


12-8-7 


A logical AND 


& ampersand 


& ampersand 


67 


67 


0046 


6-8-7 


12 


^ superscript 


' apostrophe 


' apostrophe 


70 


70 


0047 


11-8-5 


8-5 


.!. Rnhcrrint - 


? "usstion inark 






t 1 








V r - 




; ^u&bbxuu Sialic 




1 X. 


Liu// 


ii-6-6 


u-o-/ 


< less than 


< less than 


< less than 


72 


72 


0074 


12-0 


12-8-4 


> greater than 


> greater than 


> greater than 


73 


73 


0076 


11-8-7 


0-8-6 


< less or equal 


@ commercial at 




74 






8-5 


8-4 


> greater or equal 


\ reverse slant 


\ reverse slant 


75 


75 


0134 


12-8-5 


0-8-2 


- logical NOT 


circumflex 




76 






12-8-6 


11-8-7 


; semicolon 


; semicolon 


; semicolon 


77 


77 


0073 


12-8-7 


11-8-6 






@ commercial at 


74t 


7401 


0100 










circumflex 


76t 


7402 


0136 






**iiiliii**i*li^ 


IHiiliiHliiillMIBIil 


: colonl 


■IIIIII 
"74? 


74Q4T 

7404 

7407 


IBIiii 

0140 


llllllllll 


itimiill! 


mmmM9mmmmmmmm«mMm 




A pl'iClgfil Big.'. 

grave accent 






a 




7601 


0141 










b 




7602 


0142 










c 




7603 


0143 










d 




7604 


0144 










e 




7605 


0145 










f 




7606 


0146 










g 




7607 


0147 






fThe interpretation < 


)f this character or code may depend on its 


context. 


Refer 


to Chars 


icter Set 


Anomalies 


elsewhere in this ap 


pendix. 
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Table A-2. Character Sets for Batch Jobs (Sheet 3 of 3) 



CDC 
/> 1. 1 _ 

(64 Character) 


ASCII 

Graphic 

(64 Character) 


ASCII 

Graphic 

(95 Character) 


6-Bit 

Display 

Code 


6/ 12-Bit 
Display 

Code 


7-Bit 
ASCII 
Code 


tMnch 


Jode 


026 


029 






h 




7610 


0150 










i- 




7611 


15 1 










i 




7612 


0152 










k 




7613 


0153 










1 




7614 


0154 










m 




7615 


0155 










n 




7616 


0156 















7617 


0157 










P 




7620 


0160 










q 




7621 


0161 










r 




7622 


0162 










s 




7623 


0163 










t 




7624 


0164 










u 




7625 


0165 










V 




7626 


0166 










w 




7627 


0167 










X 




7630 


0170 










y 




7631 


0171 










z 




7632 


0172 










{ opening brace 


6lt 


7633 


0173 










I vertical line 


75t 


7634 


0174 










} closing brace 


62t 


7635 


0175 










~ tilde 


76+ 


7636 


0176 






tThe interpretation of this character or cc 
elsewhere in this appendix. 


)de may depend on its 


nontext. 


Refer to Character Set 


Anomalies 



60459690 C 



A-9 



Table A-3. ASCII to 6/12-Bit Display Code Conversion (Sheet 1 of 2) 



ASCII 


7-Bit 


6/12-BIt 


ASCII 


7 


-Bit 


6/12-Bit 


Character 
(128 Character) 


ASCII Code 


Display 
Code 


Character 
(128 Character) 


ASCII Code 


Display 
Code 


Octal 


Hexadecimal 


Octal 


Hexadecimal 


NUL 


4000 


00 


7640 





0060 


30 


33 


SOH 


0001 


01 


7641 


1 


0061 


31 


34 


STX 


0002 


02 


7642 


2 


0062 


32 


35 


ETX 


0003 


03 


7643 


3 


0063 


33 


36 


EOT 


0004 


04 


7644 


4 


0064 


34 


37 


ENQ 


0005 


05 


7645 


5 


0065 


35 


40 


ACK 


0006 


06 


7646 


6 


0066 


36 


41 


BEL 


0007 


07 


7647 


7 


0067 


37 


42 


BS 


0010 


08 


7650 


8 


0070 


38 


43 


HT 


0011 


09 


7651 


9 


0071 


39 


44 


LF 


0012 


0A 


7652 


: colon tf 


0072 


3A 


7404tt 


VT 


0013 


0B 


7653 


t colons- -" \ *.&■'■■■ ' s 




3A 


s« 


FF 


0014 


OC 


7654 


; semicolon 


0073 


3B 


77 


CR 


0015 


0D 


7655 


< less than 


0074 


3C 


72 


SO 


0016 


0E 


7656 


= equal 


0075 


3D 


54 


SI 


0017 


OF 


7657 


> greater than 


0076 


3E 


73 










? question mark 


0077 


3F 


71 


DLE 


0020 


10 


7660 










DC1 


0021 


11 


7661 


@ commercial at 


0100 


40 


7401 


nr"5 


/\rs*jo 


1 


7652 


i. 


-> . ~ . 




n * 










Uiui 


41 


Ul 


DC3 


0023 


13 


7663 


B 


0102 


42 


02 


DC4 


0024 


14 


7664 


C 


0103 


43 


03 


NAK 


0025 


15 


7665 


D 


0104 


44 


04 


SYN 


0026 


16 


7666 


E 


0105 


45 


05 


ETB 


0027 


17 


7667 


F 


0106 


46 


06 










G 


0107 


47 


07 


CAN 


0030 


18 


7670 










EM 


0031 


19 


7671 


H 


0110 


48 


10 


SUB 


0032 


1A 


7672 


I 


0111 


49 


11 


ESC 


0033 


IB 


7673 


J 


0112 


4A 


12 


FS 


0034 


1C 


7674 


K 


0113 


4B 


13 


GS 


0035 


ID 


7675 


L 


0114 


4C 


14 


RS 


0036 


IE 


7676 


M 


0115 


4D 


15 


ust 


0037 


IF 


7677t 


N 


0116 


4E 


16 













0117 


4F 


17 


space 


0040 


20 


55 










! exclamation point 


0041 


21 


66 


P 


0120 


50 


20 


" quote 


0042 


22 


64 


Q 


0121 


51 


21 


$ number sign 


0043 


23 


60 


R 


0122 


52 


22 


$ dollar sign 


0044 


24 


53 


S 


0123 


53 


23 


% percent signtt 


0045 


25 


63tt 


T 


0124 


54 


24 


* * ***o u 


|l*» 


« 


, HOi 


U 


0125 


55 


25 


& ampersand 


0046 


26 


67 


V 


0126 


56 


26 


' apostrophe 


0047 


27 


70 


W 


0127 


57 


27 


( opening parenthesis 


0050 


28 


51 


X 


0130 


58 


30 


) closing parenthesis 


0051 


29 


52 


Y 


0131 


59 


31 


* asterisk 


0052 


2A 


47 


Z 


0132 


5A 


32 


+ plus 


0053 


2B 


45 


[ opening bracket 


0133 


5B 


61 


, comma 


0054 


2C 


56 


\ reverse slant 


0134 


5C 


75 


- dash 


0055 


2D 


46 


] closing bracket 


0135 


5D 


62 


. period 


0056 


2E 


57 


circumflex 


0136 


5E 


7402 


/ slant 


0057 


2F 


50 


underline 


0137 


5F 


65 


^Reserved for network u 


se. Refer to Charac 


ter Set Tables 


in this appendix. 








TtThe interpretation of 


this character or co 


de may depend 


on its context. Refer 


to Chara 


cter Set Anom 


alies in 


this appendix. 
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"able A-3. ASCII to 6/12-Bit Display Code Conversion (Sheet 2 of 2) 



ASCII 


7-Blt 


6/ 12-Bit 


ASCII 


7-Bit 


6/12-Bit 


Character 
(128 Character) 


ASCII Code 


Display 
Code 


Character 
(128 Character) 


ASCII Code 


Display 
Code 


Octal 


Hexadecimal 


Octal 


Hexadecimal 


' grave accent 


0140 


60 


7407 


P 


0160 


70 


7620 


a 


0141 


61 


7601 


H 


U1V J. 


71 


/0£ J. 


b 


0142 


62 


7602 


r 


0X62 


72 


7622 


c 


0143 


63 


7603 


s 


0163 


73 


7623 


d 


0144 


64 


7604 


t 


0164 


74 


7624 


e 


0145 


65 


7605 


u 


0165 


75 


7625 


f 


0146 


66 


7606 


V 


.0166 


76 


7626 


8 


0147 


67 


7607 


w 


,0167 


77 


7627 


h 


0150 


68 


7610 


X 


0170 


78 


7630 


i 


0151 


69 


7611 


y 


0171 


79 


7631 


J 


0152 


6A 


7612 


z 


0172 


7A 


7632 


k 


0153 


6B 


7613 


{ opening brace 


0173 


7B 


7633 


1 


0154 


6C 


7614 


! vertical line 


0174 


7C 


7634 


m 


0155 


6D 


7615 


} closing brace 


0175 


7D 


7635 


n 


0156 


6E 


7616 


~ tilde 


0176 


7E 


7636 





0157 


6F 


7617 


DEL 


0177 


7F 


7637 
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JOBS USING MAGNETIC TAPE 

Coded data to be copied from mass storage to magnetic tape is assumed to be represented in 
display code. NOS converts the data to external BCD code when writing a coded seven-track 
tape and to ASCII or EBCDIC code (as specified on the tape assignment command) when writing 
a coded nine-track tape. 

Because only 63 characters can be represented in seven-track even parity, one of the 64 
display codes is lost in conversion to and from external BCD code. The following shows the 
differences in conversion depending on the character set (63 or 64) which the system uses. 
The ASCII character for the specified character code is shown in parentheses. The output 
arrow shows how the 6-bit display code changes when it is written on tape in external BCD. 
The input arrow shows how the external BCD code changes when the tape is read and converted 
to 6— bit display code. 

63-Character Set 



6-Bit Display Code 



00 




33 


(0) 







Output 



External BCD 
16 (%) 
12 (0) 



Input 



6-Bit Display Code 
00 
33 (0) 

■3 o /r>\ 



64-Character Set 



6-Bit Display Code 
00 (:) 
33 (0) 
63 (%) 



Output 



External BCD 
12 (0) 
12 (0) 
16 (%) 



6-Bit Display Code 



Input 



33 


(0) 


33 


(0) 


63 


(%) 



If a lowercase ASCII or EBCDIC code is read from a nine-track coded tape, it is converted to 
its uppercase 6-bit display code equivalent. To read and write lowercase ASCII or EBCDIC 
characters, you must use the FCOPY utility (refer to Volume 3, System Commands). 

Tables A-4 and A-5 show the character set conversion for nine-track tapes. Table A-4 lists 
the conversions to and from the 7-bit ASCII character code and 6-bit display code. Table 
A-5 lists the conversions between the EBCDIC character code and the 6-bit display code. 
Table A-6 shows the character set conversions between external BCD and 6-bit display code 
for seven-track tapes . 
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Table A-4. Nine-Track ASCII Coded Tape Conversion 







6 Bit 




6-Bit 






Display 




Display 


7-Bit ASCII 




Code 


7-bit ASCII 


Code 


Code 




Code 






Code 


Code 




Code 






Code 


vHeX; 


Chart 


(Hex) 


Char T i 


Char 


(Octal) 


''Hex* 1 


ctiar^ 




fu^-^vt 


\jiiaX 


vpetal) 


20 


space 


00 


NUL 


space 


55 


3E 


> 


IE 


RS 


> 


73 


21 


! 


7D 


} 


! 


66 


3F 


7 


IF 


US 


» 


71 


22 


■1 


02 


STX 


11 


64 


40 


@ 


60 


% 


@ 


74 


23 


# 


03 


ETX 


# 


60 


41 


A 


61 


a 


A 


01 


24 


$ 


04 


EOT 


$ 


53 


42 


B 


62 


b 


B 


02 


25 


Z 


05 


ENQ 


% 


63 


43 


C 


63 


c 


c 


03 


mm 


* 


OS 






WSt 


44 


D 


64 


d 


D 


04 


26 


& 


06 


" ack ** 


& 


67 


45 


E 


65 


e 


E 


05 


27 


/ 


07 


BEL 


* 


70 


46 


F 


66 


f 


F 


06 


28 


( 


08 


BS 


( 


51 


47 


C 


67 


g 


G 


07 


29 


) 


09 


HT 


) 


52 


48 


H 


68 


h 


H 


10 


2A 


* 


0A 


LF 


* 


47 


49 


I 


69 


i 


I 


11 


2B + 


0B 


VT 


+ 


45 


4A 


J 


6A 


j 


J 


12 


2C , 


OC 


FF 


» 


56 


4B 


K 


6B 


k 


K 


13 


2D 


- 


0D 


CR 


- 


46 


4C 


L 


6C 


1 


L 


14 


2E 


. 


0E 


SO 


. 


57 ' 


4D 


M. 


6D 


m 


M 


15 


2F 


/ 


OF 


SI 


/ 


50 


4E 


N 


6E 


n 


N 


16 


30 


10 


DLE 





33 


4F 





6F 


o 





17 


31 


1 ! 11 


DC1 


1 


34 


50 


P 


70 


p 


1 P 


20 


32 


2 


12 


DC2 


2 


35 


51 


Q 


71 


q 


i 

Q 


21 


33 


3 


13 


DC3 - 


3 


36 


52 


R 


72 


r 


! R 


22 


34 


4 


14 


DC4 


4 


37 


53 


S 


73 


s 


s 


23 


35 


5 15 


NAK 


5 


40 


54 


T 


74 


t 


i T 


24 


36 


6 


16 


SYN 


6 


41 


55 


U 


75 


u 


U 


25 


37 


7 


17 


ETB 


7 


42 


56 


V 


76 


V 


V 


26 


38 


8 


18 


CAN 


8 


43 


57 


w 


77 


w 


H 


27 


39 


9 


19 


EM 


9 


44 


58 


X 


78 


X 


X 


30 


3A 


: 


1A 


SUB 


; 


00 


59 


Y 


79 


y 

z 


Y 


31 


«-8it U*pl» 


y cod* 80 i« «mtel ined *t »ti 


■§h trtiflfc 


5A 


Z 


7A 


Z 


32 


the 63-«terc* 


^^^■•■■■■■■■•^^■■■l 


5B 


[ 


1C 


FS 


[ 
\ 


61 


3* 


IIHIIfll! 


• kk 


SUB 


> 


« 1 


1 5C 


\ 


7C 


! 


75 


3B 


, 


IB 


ESC 


» 


77 


5D 


] 


01 


SOH 


] 


62 


3C 


< 


7B 


{ 


< 


72 


5E 




7E 


~ 




76 


3D 


■ 


ID 


GS 


■ 


54 


5F 


— . . 


7F 


DEL 




65 


tWhen these characters are copied from/or to a tape, the characters remain the same but 


the codes change 


from one code set to the other. 




ttThese characters do not exist in 6-bit display code. Therefore, when the characters are copied from a 1 


tape, each 7-bit ASCII character is changed to an alternate 6-bit display code charact 


er. The 


corresponding codes are also changed. Example: When the system copies a lowercase a, 


61 16, from tape, 


it writes an uppercase A, Olg. 




tttA 6-bit display code space always translates to a 7-bit ASCII space. 
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Table A-5. Nine-Track EBCDIC Coded Tape Conversion 



: 


6-Bit 








6-Bit 




Display 








Display 


EBCDIC 


Code 




EBCDIC 




Code 


Code 




Code 






Code 


Code 




Code 






Code 


(Hex) 


Chart 


(Hex) 


Chartt 


Chartt 


(Octal) 


(Hex) 


Chart 


(Hex) 


Chartt 


Char 


(Octal) 


40 


space 


CO 


NHL 


space 


55 


C4 


D 


84 


d 


D 


04 


4A 


i 


1C 


IFS 


[ 


61 


C5 


E 


85 


e 


E 


05 


4B 


. 


0E 


SO 


. 


57 


C6 


F 


86 


f 


F 


06 


4C 


< 


CO 


{ 


< 


72 


C7 


G 


87 


g 


G 


07 


4D 


( 


16 


BS 


( 


51 


C8 


H 


88 


h 


H 


10 


4E 


+ 


OB 


VT 


+ 


45 


C9 


I 


89 


i 


I 


11 


4F 


1 


DO 


} 


! 


66 


Dl 


J 


91 


j 


J 


12 


50 


& 


2E 


ACK 


& 


67 


D2 


K 


92 


k 


K 


13 


5A 


I 


01 


SOH 


I 


62 


D3 


L 


93 


1 


L 


14 


5B 


$ 


37 


EOT 


$ 


53 


D4 


M 


94 


m 


M 


15 


5C 


* 


25 


LF 


* 


47 


D5 


N 


95 


n 


N 


16 


5D 


) 


05 


HT 


) 


52 


D6 





% 


o 





17 


5E 


* 


27 


ESC 


> 


77 


D7 


P 


97 


P 


P 


20 


5F 


- 


Al 


— 


* 


76 


D8 


Q 


98 


q 


Q 


21 


60 


- 


0D 


CR 


- 


46 


D9 


R 


99 


r 


R 


22 


61 


/ 


OF 


SI 


/ 


50 


E0 


\ 


6A 


1 


\ 


75 


6B 


s 


OC 


FF 


, 


56 


E2 


S 


A2 


s 


S 


23 


r 60 


Z 


2D v 1 


ENQ 


X 


63 


E3 


T 


A3 


t 


T 


24 




* 




■ft;#32gsjj!ia ^iSSK^MfsS 


E4 


U 


A4 


u 


U 


25 


6D 




07 


DEL 




65 


E5 


V 


A5 


V 


V 


26 


6E 


> 


IE 


IRS 


> 


73 


E6 


w 


A6 


w 


w 


27 


6F 


•> 


IF 


IDS 


•> 


71 


E7 


X 


A7 


X 


X 


30 


7A 


: 


3F 


SUB 


• 


00 


E8 


Y 


A8 


y 


Y 


31 


I &*$&*!&&*$ ***** 


l^^kHmi #r *Hm mint 


E9 


Z 


A9 


z 


Z 


32 


■■%?» <&&UtXecHr ***** 


F0 





10 


DLE 





33 


^W 


i 


'■'■■ *- 


turn 


Btlllllpl 


«$ 


Fl 


1 


11 


DC1 


1 


34 


7B 


# 


03 


ETX 


# 


60 


F2 


2 


12 


DC2 


2 


35 


7C 


e 


79 


\ 


e 


74 


F3 


3 


13 


TM 


3 


36 


7D 


' 


2F 


BEL 


' 


70 


F4 


4 


3C 


DC4 


4 


37 


7E 


» 


ID 


IGS 


= 


54 


F5 


5 


3D 


NAK 


5 


40 


7F 


it 


02 


STX 


ti 


64 


F6 


6 


32 


SYN 


6 


41 


CI 


A 


81 


a 


A 


01 


F7 


7 


26 


ETB 


7 


42 


C2 


B 


82 


b 


B 


02 


F8 


8 


18 


CAN 


8 


43 


C3 


C 


83 


c 


C 


03 


F9 


9 


19 


EM 


9 


44 


TWhen these characters are copied from/ or to a tape, th 


s characters rema 


in the sa 


ne (except EBCDIC codes 


4A, 4F, 5A, and 5F) but the codes change from one code 


set to the other 






TtThese characters do not exist in 6-bit display code. 


Therefore, when t 


he .charac 


ters are copied from a 


tape, each EBCDIC character is changed to an alternate 


6-bit display cc 


■de charac 


ter. The corresponding 


codes are also changed. Example: When the system cop 


Les a lowercase i 


> 81i6, from tape, it writes an 


uppercase A, 01 8 . 
TlTAll EBCDIC codes not listed translate to 6-bit display 








code 55g (space] 


. A 6-bi 


t display code space 


always translates to an EBCDIC space. 
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Table A-6. Seven-Track Coded Tape Conversions 







6-Bit 






6-Bit 






Display 






Display 


External 


ASCII 


Code 


Be tern al 


ASCII 


Code 


BCD 


Character 


(Octal) 


BCD 


Character 


(Octal) 


01 


1 


34 


40 


_ 


46 


02 


2 


35 


41 


J 


12 


03 


3 


36 


42 


K 


13 


04 


4 


37 


43 


L 


14 


05 


5 


40 


44 


M 


15 


06 


6 


41 


45 


N 


16 


07 


7 


42 


46 





17 


10 


8 


43 


47 


P 


20 


11 


9 


44 


50 


Q 


21 


12t 





33 


51 


R 


22 


13 


= 


54 


52 


I 


66 


14 


ii 


64 


53 


$ 


53 


15 


@ 


74 


54 


* 


47 


16t 


% 


63 


55 


* 


70 


17 


[ 


61 


56 


? 


71 


20 


space 55 


57 


> 


73 


21 / j 50 


60 


+ 


45 


22 j S 


23 


61 


A 


01 


23 1 T 


24 


62 


B 


02 


24 t U 


25 


63 


C 


03 


25 I V 


26 


64 


D 


04 


26 


W 


27 


65 


E 


05 


27 


X 


30 


66 


F 


06 


30 


Y 


31 


67 


6 


07 


31 


Z 


32 


70 


H 


10 


32 


] 


62 


71 


I 


11 


33 


J 


56 


72 


< 


72 


34 


( 


51 


73 


• 


57 


35 




65 


74 


) 


52 


36 


1 


60 


75 


\ 


75 


37 


& 


67 


76 


* 


76 








77 


5 


77 


tAs explained previously 


in this 


section, < 


inversion 


of these codes depends 


on **ie the 


r the tape 


is being 


read or written. 
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MESSAGES B 



This appendix contains an alphabetical listing of the messages that may appear in your 
dayfile. Lowercase characters are used to identify a variable names or fields. All 
messages are sorted according to the first nonvariable word or character. Messages 
beginning with special characters (such as hyphens or asterisks) are sorted as if the 
special character(s) were not present. For example, the message 

filenam ALREADY PERMANENT, AT addr. 
is listed with the messages beginning with A, and the message 

**** ENDING SUPPORT OF LFM FUNCTION nnB. 

is listed with the messages beginning with E. 

This appendix contains messages of interest to the applications COMPASS programmer. 
Messages pertaining to general job processing are contained in appendix B of Volume 3, 
System Commands. 

If you encounter a diagnostic or informative message that does not appear in this appendix, 
consult the NOS 2 Diagnostic Index. This publication catalogs all messages produced by NOS 
and its products and specifies the manual or manuals in which each message is fully 
documented . 
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MESSAGE 



ACCESS CATEGORIES HOT VALID FOR JOB. 



ACCESS LEVEL NOT VALID FOR FILE. 



ACCESS LEVEL MOT VALID FOR FILE 
filename AT address. 



ACCESS LEVEL NOT VALID FOR JOB. 



ACCESS LEVEL HOT VALID FOR JOB, 
filename AT address. 



ACCESS LEVEL NOT VALID ON PF DEVICE. 



ACCOUNT BLOCK LIMIT. 



ADDRESS OUT OF RANGE, 
filename ALREADY PERMANENT. 

ARG. ERROR. 

ARITHMETIC INDEFINITE. 

ARITHMETIC OVERFLOW. 

ARITHMETIC UNDERFLOW. 

est, ASSIGNED TC filename. 
ttest, ASSIGNED TO filename. 



SIGNIFICANCE 

You attempted to use the SETPFAC command 
or macro to set one or more permanent file 
access categories for which you are not 
validated. 



One of the. following. 

- You attempted to save a local file 
using an access level for the 
permanent file that is not valid for 
the device on which the locaL file 
resides. 

You attempted to define an existing 
local file as a direct access 
permanent file using an access level 
for the permanent file that is not 
valid for the device on which the 
local file resides. 

The access level of your job is not valid 
for the device on which file filename 
resides. 

One of the following: 

You attempted to save a local file 
at an access level that is not valid 
for your job. 

You attempted to define an existing 
local file as a direct access 
permanent file at an access level 
that is not valid for your job. 
You attempted to set an access level 
for a permanent file that is not 
valid for your job using the SETPFAL 
command or macro. 

The access level specified in the FET for 
file filename is not within your job's 
access level limits. 

On a SAVE, DEFINE, or SETPFAL command or 
macro, you specified an access level that 
is outside the range of access levels 
allowed on your permanent file device. 



The monitor detected the expiration of the 
account block SRU Limit. 



An address in a parameter block is outside 
the job's field length. 



You have already saved or defined a file 
with the name specified. 



LDR parameters were outside your job's 
field length or the central memory address 
in call is not within your job's field 
length. 

The CPU floating-point arithmetic unit 
attempted to use an indefinite operand. 



The CPU floating-point arithmetic unit 
received an operand too large for 
computation. 

The CPU floating-point arithmetic unit 
received an operand too small for 
computation. 

Informative message specifying EST ordinal 
assigned to file filename. 

Equipment type tt with EST ordinal est was 
assigned to fiLe filename. 



ACTION 

Retry using a set of 
access categories for 
which you are validated 
and that is valid for 
your job. 

Retry using an access 
level for the permanent 
file that is not lower 
than the access level of 
the local file. 



ROUTINE 
PFM 



None. You may not write on 
this file while your job is 
at the current access level. 

Retry using a valid access 
level. 



1MS 



None. You may not create 1MS 
the file at this access level. 



Inform security 
administrator that 
your permanent file 
device is not valid for 
all the access levels 
for which you are 
validated. 



Reset account block SRU 
limit with SETASL 
command or macro. If 
the account block limit 
is set at its maximum, 
issue another CHARGE 
command to begin a new 
account block. 

Specify parameter block 
address within field 
length. 

Save or define file 
using different file 
name or purge existing 

file. 

Examine program to 
determine error. 



Analyze the job output 
and dumps to determine 
the cause. 

Analyze the job output 
and dumps to determine 
the cause. 

Analyze the job output 
and dumps to determine 
the cause. 

None. 



1AJ 



LFM 



PFM 



None. 



1AJ 



1AJ 



1AJ 



LFM 



LFM 
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jsn ASSIGNS EXCEED DEMANDS. 



BAD CATALOG/PERMIT SECTOR. 



SIGNIFICANCE 

RESEX internal problems occurred. The 
resources actually assigned to the job with 
the specified job sequence name exceed the 
resources demanded on a RESOURC command. 

PFM has encountered a catalog or permit 
sector which does not have a valid sector 
length. This indicates corruption of 
system areas on disk. 



Inform site analyst. 



Inform site analyst. 
If many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE^ 
and full PFLOAD on the 
device. 



ROUTINE 
RESEX 



PFM 



BLANK TAPE, filename AT address. 

BLOCK SEQUENCE ERROR, filename AT address. 

BLOCK TOO LARGE, filename AT address. 

BOT/EOT ENCOUNTERED, filename AT address. 
BREAKPOINT CONDITION. 
BUFFER ARG. ERROR. 

BUFFER ARGUMENT ERROR, filename AT address. 



BUFFER CONTROL WORD ERROR, filename AT 
address. 



BUFFER CONTROL WORD ERROR ON filename AT 

address. 



pfn BUSY. 

CHANNEL MALFUNCTION, f Rename AT address 
CHECKPOINT nnnn COMPLETE. 

CHECKPOINT nnnn COMPLETED TO filename. 

CHECKPOINT FILE ACCESS LEVEL ERROR. 



CHKPT UNABLE TO READ TAPE. 



CTO ERROR. 



A blank tape was read. Blank tape is 
defined as more than 25 feet of erased tape. 

The block length recorded in the file did 
not match the length of the block read, or 
the block number recorded in the file did 
not match the system block count (this 
message applies to I format tapes only). 

The tape being read contained a data block 
greater in size than that allowed by the 
specified format or by your specification. 

Indicates an abnormal tape position. 



The job executed an address for which a 
breakpoint was requested by the system. 

CM address in call is not less than the 
field length minus the word count; buffer 
extends past the job's field Length. 



For tape operations, this message indicates 
one of the following. 

- FET less than 7 words long for S/L format 

- MLRS greater than 1000 octal for S format 

- POSMF issued and no HDR1 label found in 
FET or extended label buffer 

Either an attempt was made to write a block 
smaller than the noise size on an S, L, or 
F format tape, or a control word error 
occurred in a write (such as bad byte 
count). 

Block length specified on URITECW operation 
exceeds the allowable physical record size 
for the device. 



) he speciTiea oirect access TiLe is 
currently attached in an incompatible 
mode, or is already being accessed by 
4095 users in your specified mode CR, 
RA, RU, or RM). 

A hardware malfunction occurred. 

Indicates that checkpoint nnnn has 
completed. Issued if only one checkpoint 
file is present. 

Indicates that checkpoint nnnn has been 
completed to file filename. Issued if 
alternate CB checkpoint files are used. 



In a secure system, 
access Level is not 
access Level limit, 
the checkpoint file 
contain all local f 
of the checkpoint f 
this Level since th 
magnetic tape files 
permanent file, and 
file types used for 



the checkpoint file 
the same as the job 
This is to insure that 
is secure enought to 
iles. The access level 
ile is not changed to 
is is not possible for 
or direct access 
these are the usual 
checkpoint files. 



CKP REQUEST. 
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Indicates a tape file had an unrecovered 
parity error when CHKPT tried to write it 
to the checkpoint file. 

Updating of resource file returned error 
status other than end-of-device. 

A checkpoint has been initiated. 



Ensure correct tape is 
specified on command. 

Ensure accuracy of 
format parameter CF) on 
command or macro. 



Ensure accuracy of 
format parameter CF) on 
command or macro. 

Inform site analyst if 
persistent. 

Inform software support. 



Verify that operation 
does not reference 
address beyond end of 
buffer or job's field 
length. 

Examine program to 
determine error. 



Examine program to 
determine error. 



Correct the program that 
is formatting the data 
for the WRITECW 
operat ion. 

Reissue ATTACH until 
file becomes available, 
or issue ATTACH 
specifying WB option. 



Inform site analyst. 
None. 

None. 



Insure that the access 
level of the checkpoint 
file is the same as the 
job access level upper 
limit. 



None. 



Inform site analyst. 



1MT 



1MT 



1MT 



1AJ 



1AJ 
TCS 



1MT 



1MT 



1MS 



1MT 
CHKPT 



RESEX 
CHKPT 

8-3 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CM BLOCK OUT OF RANGE. 



CM OR EC REQUEST EXCEEDS MAXIMUM. 



CM OUT OF RANGE. 



CM PARITY ERROR. 



CM RANGE EXIT MODE NOT DESELECTABLE. 



CMC PARITY ERROR. 



CONNECT REJECT, filename AT address. 



CONTENTS NOT CHECKPOINTED FOR FILE xxxxxxx 



CONTROL *OAC* ERROR nnn. 



CONTROLLED BACKSPACE ERROR, filename AT 
address. 



CPM - ACCESS LEVEL NOT VALID FOR JOB. 

CPM - ARGUMENT ERROR. 

CPM - INCORRECT PACK NAME. 

CPM - INCORRECT REQUEST. 



Data transfer from extended memory 
specified a CM address outside the job 
field Length. 

Field length of more than 77000 octal (CM) 
or more than 7777 octal (EM) was specified 
in RFL command. 

The program referenced an address outside 
the job CM field length. 



Double data parity error (two data bits 
failed) between central memory control 
(CMC) and CM as detected by the 
single-error correction doubLe-error 
detection (SECDED) network, or a single 
parity error when operating in default mode 
(SECDED network disabled). 

You attempted to deselect system checking 
for CM out of range errors. This cannot be 
done on a model 176. 



The CPU sent the central memory control 
(CMC) data or an address having incorrect 
parity. 

The system was unable to connect a 
peripheral device. 

A CHECKPT macro call or a CKP RA+1 call was 
made and file xxxxxxx is a tape file 
appearing in the parameter list of the 
request. The manner in which the file was 
selected for processing was other than f=4 
(position information only). Since 
magnetic tapes are not copied to the 
checkpoint file, only the position 
information was copied (f=4 was forced). 
Thus, it will be necessary to assign the 
tape to the restart job. If the contents 
of the tape is destroyed, it may not be 
possible to restart the checkpoint job 
correctly. 

A system error was encountered while making 
a QAC monitor request. 



Controlled backspace operation failed 
during write error recovery. Position of 
tape is uncertain. 

You attempted to change the job access 
Level to a value not valid for the job. 

An incorrect argument was specified. 



An incorrect pack name has been specified. 



A job was incorrect CPM function code, 
subfunction code was specified, or extended 
reprieve is set (for EREXIT). 



Analyze the job output 
and dumps to determine 
the cause. 

Retry with lower 
value(s). 



Analyze job output and 
dumps to determine the 
cause. 

Inform customer engineer. 



Determine if the program 
can run with CM range 
error checking. If it 
cannot, the program must 
be changed. 

Inform customer engineer. 



Inform site analyst. 



Save the tape for the 
restart job without 
altering the tape 
contents from the time 
of the checkpoint. To 
eliminate the message, 
select f=4 for tape 



Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 

Inform customer engineer. 



Retry with a valid level. 



Retry the command using 
valid arguments. 

Ensure that a valid pack 
name is used. 

Specify auto recall on 
monitor request call to 
CPM. 



1AJ 



CONTROL 



1AJ 



1AJ 



CPM 



1AJ 



1MT 



RESTART 



1MT 



CPM 



CPM 



CPM 



CPM - INVALID PAGE VALUE. 



There was an error in your job page size 
information. 



Retry with correct 
values. 



CPM 



CPM - LIBRARY NOT FOUND = library. 



The system could not find the 
specified Library. 



Ensure that the library 
name is correct on the 
command or macro. 



CPM 



CPM - MISSING *SHELL* LOAD OPTION. 



CPM - SECONDARY USER COMMANDS DISABLED. 



CPM - SYSTEM ERROR. 



You attempted to set a shell control 
without specifying a load option. 



You entered a secondary USER command on a 
system that has had secondary USER commands 
disabled. 

For function 42 (Special Charge) or 106 
(Set Job Characteristics), CPM was unable 
to read the input fiLe. 



Specify a load option in 

the shell command or 

macro and try again. 

None. 



write a PSR and include 
support materials to 
aLlow CDC to duplicate 
the problem. 



CPM 



CPM 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



CPU - USER ACCESS NOT VALID. 



CPU ERROR EXIT AT address. 



CVL CALL ERROR. 



DATA/PERMIT ERRORS. 



DATA TRANSFER ERROR. 



D8est,DNdn, message. 



DEFAULT FAMILY USED. 
DEMAND EXCEEDED. 

DEMAND FILE ERROR. 

DEVICE ERROR ON FILE filename AT address. 



1. You tried to perform a CPM operation for 
which you are not authorized. 

2. A CPU program issued a DSDOUT or a 
DSDINP macro request when it did not 
have access to the L display CMR buffers. 

The errors listed after this message 
occurred at address, causing job 
termination. 



If CVL was called by a user via GETMC, 
CVL encountered one of the following 
errors while processing the GETMC 
macro. 

- Recall bit was not set. 

- Illegal function number was specified. 

- Insufficient or improper combination of 
parameters was specified. 

If CVL was called by a CE via CEVAL, 
CVL encountered one of the following 
errors while processing the CEVAL macro. 

- Recall bit was not set. 

- IllegaL function number was specified. 

- Insufficient or improper combination of 
parameters was specified. 

- The CE supplied mnemonic does not 
match the preassigned tape mnemonic when 
CVL was called by p reassignment. 

- A tape was not preassigned when CVL was 
called by p reassignment. 

- The CE attempted to load tape 
controlware when CVL was called by 
preassignment. 

- A labeled tape was preassigned when CVL 
was called by preassignment. 

When the specified file was loaded from 
tape, errors were encountered in both data 
and permit information. 



An error occurred in a read operation 
during a file transfer. 



A form of PFH error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DB is 885-42 
disk (full track). 

est EST ordinal of device. 

dn Device number. 

message PFM error message. 

You entered a FAMILY command with no 
parameter. The default family was used. 

You attempted to assign more units than 
were scheduled on the RESOURC command. 



Resource execution error was encountered. 
This error occurred because the demand file 
(RSXDid) entry does not match the job 
identification. 

An irrecoverable error occurred on the mass 
storage device containing the file filename. 



Ensure that the L 
display utility was 
initiated at the system 
console with the 
appropriate commands. 

Refer to the 
descriptions of the 
error messages issued 
with this message. 

Correct error and rerun 
program. 



Enter CHANGE command or 
macro with CE parameter 
to allow access to the 
f i le. Make the f i le 
local and check if data 
is accurate. Enter a 
CATLIST command to see 
if the permits are 
accurate. 

Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 

Refer to the 
significance and action 
of the message as given 
in this list of error 
messages. 



None. 



Increase appropriate 
parameter value on 
RESOURC command. 

Inform site analyst. 



Inform customer engineer. 



1AJ 



CVL 



PFM 



CONTROL 



RESEX 



1MS 
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MESSAGE 



DEVICE UNAVAILABLE. 



DIest,DNdn, message. 



DIRECT ACCESS DEVICE ERROR. 



DIRECT ACCESS FILE ERROR. 



SIGNIFICANCE 

One of the following: 

- A packname was specified for a pack that 
is not currently mounted. 

- For a DIS job, no SUI or USER command 
has been entered. 

- No permanent file device could be found 
for your user name. 

- On a secure system, no permanent file 
device with the proper access level 
could be found for your user name. 

A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DI is 844-21 
disk (half track). 

est EST ordinal of device. 

dn Device number. 

message PFH error message. 

One of the following occurred. 

- An incorrect device type was specified. 

- The device on which the Local file 
resides may not contain direct access 
files. 

The system sector for the file contains 
incorrect data or cannot be read. 



ACTION 

If a packname was 
specified, try again 
with the KB or NA 
parameter to request 
that the pack be 
mounted. For other 
errors, inform site 
operator. 



Refer to the 
significance and action 
of the message as given 
in this list of error 
messages. 



Specify correct device 
type, or return the 
local file and retry. 



Inform site anlyst. If 
many of these errors occur, 
the site analyst should 
perform a full PFDUMP, 
total INITIALIZE, and fuLL 
PFLOAD on the device. 



ROUTINE 



PFM 



DJest,DNrin,message. 



DKest,DNdn, message. 



DLest,DNdn, message. 



DHest,DNdn,message. 



DQest,DNdn, message. 



DSP - CANNOT ROUTE JOB INPUT FILE. 



DSP - COMPLETE BIT ALREADY SET. 



A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DJ is 844-41/44 
disk. 

est EST ordinal of device. 

dn Device number. 

message PFH error message. 

A form of PFH error message (issued to the 
system dayfile, error Log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DK is 844-21 
disk (full track). 

est EST ordinal of device. 

dn Device number. 

message PFH error message. 

A form of PFH error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DL is 844-41/44 
disk (full track). 

est EST ordinal of device. 

dn Device number. 

message PFH error message. 

A form of PFH error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DM is 885-11/12 
disk (half track). 

est EST ordinal of device. 

dn Device number. 

message PFM error message. 

A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DQ is 885-11/12 
disk (full track). 

est EST ordinal of device. 

dn Device number. 

message PFM error message. 

An attempt was made to route the job input 
file. 

The complete bit was not cleared before DSP 
was called. 



Refer to the 
significance and action 
of the message as given 
in this list of error 
messages. 



Refer to the PFM 

significance and action 

of the message as given 

in this list of error 

messages. 



Refer to the PFM 

significance and action 

of the message as given 

in this list of error 

messages. 



Refer to the 
significance and action 
of the message as given 
in this list of error 
messages. 



Refer to the PFM 

significance and action 

of the message as given 

in this list of error 

messages. 



Copy job input file to a DSP 
local file and route it. 

Clear complete bit DSP 

before calling DSP. 
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DSP - DEFERRED ROUTING NOT ALLOWED. 

DSP - DEVICE FULL. 

DSP - DEVICE UNAVAILABLE. 

DSP - FILE NAME ERROR. 

DSP - FILE NOT ON MASS STORAGE. 

DSP - FILE ON REMOVABLE DEVICE. 

DSP - FOMSM CODE NOT ALPHANUMERIC. 

DSP - I/O SEQUENCE ERROR. 

DSP - IMMEDIATE ROUTING - NO FILE. 

DSP - INCORRECT DISPOSITION CODE. 

DSP - INCORRECT EXTERNAL CHARACTERISTICS. 

DSP - INCORRECT FILE TYPE. 

DSP - INCORRECT INTERNAL CHARACTERISTICS. 
OSP - INCORRECT JOB ABORT CODE. 
DSP - INCORRECT ORIGIN TYPE. 
DSP - INCORRECT REQUEST. 

DSP - INCORRECT SERVICE CLASS 

DSP - INCORRECT SPACING CODE. 
DSP - INCORRECT TID. 



DSP - INVALID FILE MODE. 



DSP - INVALID USER CARD. 



DSP - MASS STORAGE ERROR. 



DSP - QUEUED FILE READ ERROR. 



DSP - ROUTE TO INPUT NOT IMMEDIATE. 



SIGNIFICANCE 

A file cannot be deferred routed if data 
declaration, or impLicit/expLicit remote 
text is specified. 

There is no space on the device for current 
use. 

DSP attempted to create a file on a device 
that was turned off or is currently 
unavailable for access. 

An attempt was made to create a file with 
an incorrect file name. 

An attempt was made to route a file not on 
mass storage. 

A file on a removable device cannot be 
routed. 



The forms code specification CFC=fc 
parameter) must consist of two 
alphanumeric characters. 

A request was made on a bus/ file. 



The specified file for the immediate 
routing could not be found. 



Specified disposition code is not 
recognized. 

You specified an undefined external 
characteristic code. 

The file being processed is not a queued 
file or a local f i Le. 



You specified an undefined internal 
characteristics code. 

Value of abort code field of DSP parameter 
word four is incorrect. 

The system cannot queue the file for input 
with the specified origin type. 

One of the following: 

- Parameter block is not within field 
length. 

- Request was not made with auto recall. 

The two-character service class is not 
valid for the user or the origin type of 

the file. 

Value specified for spacing code was 
greater than 77 octal. 

One of the following. 

- Username and f ami lyname parameters were 
not in CM field length. 

- Terminal identifier CTID) is greater 
than or equal to IDLM for batch jobs. 

- The fami lyname or username is not valid. 

The file being processed is attached in 
execute-only mode. 



For an operation on an input fiLe, either a 
USER command was not included, or the user 
name or password on USER command is not 
valid. 

A mass storage error was encountered on the 
file. 



DSP encountered an error while trying to 
read the system sector for a previously 
deferred routed file. 

You attempted to queue a file for input 
using a deferred ROUTE. 



ACTION 



Correct and retry. 



Retry route at a later 
time. 

Specify different device 
or contact site operator. 



Specify valid file name. 



Copy file to mass 
storage before routing. 

Copy file to 
nonremovable device 
before routing. 

Specify alphanumeric 
forms code. 



Wait until file is not 
busy. 

Ensure that file to be 
routed is available to 
job for processing. 

Verify disposition code. 



Verify external 
characteristic code. 

Ensure the file being 
processed is of the 
correct type. 

Verify internal 
characteristics code. 

Verify abort code. 



Specify valid origin 
type. 

Change parameter block 
addresses or specify 
auto recall. 



Correct and retry. 



Verify spacing code. 



Verify that TID 
parameters are valid. 



Return the file and 
reattach it in other 
than execute-only mode. 

Verify that a USER 
command is present and 
that the user name and 
password are correct. 

Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 

Attempt to recreate the 
output file. 



Change to immediate 
route. 



ROUTINE 
DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 



DSP 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



DSP - THIS ROUTING NOT ALLOWED. 



DSP - TOO MANY DEFERRED BATCH JOBS. 



DSP - UNDEFINED SERVICE CLASS. 



You attempted to change the queue 
disposition of a deferred routed file. 



You attempted to submit more deferred batch 
jobs than allowed by your validation limit. 



The two-character service class is not 
defined. 



Rescind prior routing by DSP 

using the SC disposition 

code with the ROUTE command 

or macro. Route the file 

again with the desired 

final disposition code. 

Wait for jobs to DSP 

complete or request a 
Larger validation limit 
from site personnel. 

Correct and retry. DSP 



DSP - USER ACCESS NOT VALID. 



Caller is not validated to specify one of 
the following: 

DLID 

SLID 

Data declaration 



Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 



DUPLICATE FILE NAME. 



DUPLICATED LINES. 



DVest,DNdn, message. 



DWest,DNdn, message. 



The file specified already exists in the 
system. 

Duplicate lines, which would have been 
printed during a dump operation, were 
suppressed. 

A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type is 819 disk 
(single density). 

est EST ordinal of device. 

dn Device number. 

message PFM error message. 

A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type DW is 819 disk 
(double density). 

est EST ordinal of device. 

dn Device number. 

message PFM error message. 



Use different name in LFH 
request. 

None. CPMEM 



Refer to the significance PFM 
and action of the message 
as given in this list of 
error messages. 



Refer to the PFM 

significance and action 

of the message as given 

in this list of error 

messages. 



EC NOT VALIDATED. 



The number of extended memory blocks 
specified on the Job command either exceeds 
that for which you are authorized or 
exceeds the machine size available to user 
jobs. 



Check your validation 
with the LIMITS command. 



CPM 



ECS LOAD ERROR. 

filename EMPTY. 

END OF TAPE, filename AT address. 

ENTRY POINT NOT FOUND. 
EOI CHANGED BY RECOVERY. 



EQUIPMENT NOT AVAILABLE. 



ERASE LIMIT, filename AT address. 



ERROR CODE ec, filename AT address. 



An error occurred during ECS load. 

The file specified on a SAVE command 
contains no data. 

The end-of-tape was encountered. 



The specified entry point could not be 
found. 

The file was truncated during deadstart 
recovery. 



The requested equipment is either in use 
or does not exist, or no requested 
equipment with the proper access level 
can be found. 

The system made 20 erasures (10 feet of 
tape) without being able to successfully 
write the tape. 

1MT error code ec has occurred but no 
specific message is issued. This would 
normally not occur unless the job was 
dropped by the operator. 



Inform site analyst. 

Verify that file 
contains data and retry. 

Ensure that correct file 
manipulation operation 
is specified. 

Verify that entry point 
is valid. 

Use CHANGE command or 
macro with CE parameter 
to allow access to the 
file. Make the file 
local and list it to 
determine how much of 
the file was lost. 

Ensure accuracy of macro 
or command or retry at a 
later time. 



Clean tape or use 
different tape. 



Inform site analyst. 



1AJ 
PFM 

1MT 

1AJ 
PFM 



LFM 
RESEX 



1MT 



1MT 
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SIGNIFICANCE 



ACTION 



ROUTINE 



ERROR - FILES(S) NOT PROCESSED. 



ERROR FLAG TERMINATION, filename AT address. 



ERROR FLAG TERMINATION, FILE filename AT 
address 



ERROR IN FILE DATA. 



ERROR IN PERMIT DATA. 



ERROR IN ROUTE FUNCTION, LFN=f i lename. 



ERROR ON FILE - PROFILa. 



EXCHANGE PACKAGE/MEMORY DUMP ON FILE 
ZZZDUMP. 



EXTENDED MEMORY BLOCK OUT OF RANGE. 

EXTENDED MEMORY FLAG REGISTER PARITY. 
EXTENDED MEMORY OUT OF RANGE. 

EXTENDED MEMORY PARITY ERROR. 
FAMILY NOT FOUND. 

FET ADDRESS OUT OF RANGE AT address. 

FET PARAMETER ERROR ON filename AT address. 

FET TOO SHORT. 

FIELD BEGINNING AT nn NO COMPARE. 

FILE BOI/EOI/UI MISMATCH. 



FILE EMPTY. 

FILE ERROR filename. 

FILE/JOB NOT FOUND. 



One or more fiLes were not checkpointed 
because CHKPT detected an error while 
getting a list of the files at the control 
point. This could occur if there are many 
local files. 

The job was aborted with a tape operation 
in progress. The operation/request is not 
complete. For example, the operator could 
kill the job white tape error recovery is 
in progress. 

The job was aborted with an input/output 
request in progress. The operation/request 
is not complete. 

When the specified file was loaded from 
tape, an error was encountered in the data* 



When the specified file was loaded from 
tape, an error was encountered in the 
permit entries. 



Informative message issued to the system 
dayfile indicating that an error occurred 
while routing filename. 

Either the profile file cannot be found or 
there is a bad profile file level-3 block 
random address. 

The exchange package and memory dump is 
written on local fiLe ZZZDUMP because the 
job is of interactive origin and file 
OUTPUT is assigned to a terminal. 

Data transfer between CM and extended 
memory specified an extended memory address 
outside the job field length. 

Parity error detected on extended memory 
flag register operation. 

Job referenced extended memory address 
outside job field length. 



ECS transfer on a model 176 failed. 

No family exists with the name you 
specified. 

FET extends past job's field length or FET 
address .LE. 1. 

One flf the flaraoetexs in the FET is 

incorrect or the FET is not Long enough for 
the parameter. 

FET is not long enough for processing by 
requested function. 

Verification of label field at character 
position nn does not compare with that 
specified by the user on an OPEN statement. 

Data in the system sector for file filename 
does not match information from the EOI 
sector and/or catalog information. This 
indicates that the file has been destroyed. 



The file specified was empty. 



An incorrect address was detected on file 
filename. 

The specified file or job was not found in 
the system. 



Contact Central Software 
Support. 



None. 



1MT 



Enter CHANGE command or 
macro with CE parameter 
to allow access to the 
file. Make the file 
local and ensure the 
accuracy of the data. 

Enter CHANGE command or 
macro with CE parameter 
to allow access to the 
file. Do a CATLIST to 
see if the permits are 
accurate. 

Examine the job's 
dayfile for a more 
specific error message. 

Inform site analyst. 



To examine the exchange 

package and dump, list 
file ZZZDUMP. 



Analyze the job output 
and dumps to determine 
the cause of the error. 

Inform customer engineer. 



Analyze the job output 
and dumps to determine 
the cause of the error. 

Inform customer engineer. 

Retry with an existing 
family name. 

Verify that FET address 
is valid. 

Verify that FET is vaLid. 



Increase FET size. 



None. 



Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITALIZE, 
and full PFLOAD on the 
device. 

Verify that the file 
contains data and retry. 

Correct error and retry. 



Use the ENQUIRE command 
to ensure job is still 
in the system. 



DSP 
CPM 
CPMEM 

1AJ 

1AJ 
1AJ 

1AJ 
CONTROL 

1MS 
IMS 



1MT 



LFM 
SFM 



RESTART 



CONTROL 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



FILE LENGTH ERROR. 



FILE NAME ERROR. 



FILE NOT DISK RESIDENT. 



The length of a file does not equal the 
length specified in the catalog. This 
indicates that the file has been 
destroyed. 



File name contains incorrect characters or 
contains more than seven characters. 



Access to a file which does not reside on 
disk is not permitted with the requesting 
. function. 



Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 

Ensure that a valid file 
name is specified. 



Write a PSR. 



LFM 

LISTLB 

PFM 

PFM 



FILE NOT ON MASS STORAGE. 



FILE TOO LONG. 



FILE TOO LONG, FILE filename AT address. 

FL REQUEST BEYOND MFL (ECS). 

FL TOO SHORT FOR PROGRAM. 

FLE TOO SHORT FOR LOAD. 

FNT FULL. 

FORMAT REQUIRES UNLABELED TAPE. 

FUNCTION REJECT, filename AT address. 
FWA .GE. LWA+1. 

FWA/LWA .GE. FL. 

GETFNT TABLE TOO LARGE. 
HTIBE NOT AVAILABLE. 



I/O ON EXECUTE-ONLY FILE filename AT 
address. 



I/O SEQUENCE ERROR. 



I/O SEQUENCE ERROR ON FILE filename AT 
address. 



ILLEGAL ACCESS LEVEL FOR EQUIPMENT. 



The specified file does not reside on mass 
storage. 

The local file specified for a SAVE, 
REPLACE, or APPEND command exceeds the 
length allowed or the direct access file 
specified for an ATTACH operation in WRITE, 
MODIFY, UPDATE, or APPEND mode exceeds the 
direct access file length limit for which 
you are authorized. 

The length of the direct access permanent 
file currently being written exceeds the 
direct access file length limit for which 
you are authorized. 



Extended memory field length requirements 
for the job step exceed the extended memory 
field length allowed. 

The job's field length is too short for the 
program. 



You attempted to load extended memory data 
beyond the job's extended memory field 
length. 

FNT space is currently not available for a 
request that has both the ep and up 
processing options set. 

The format specified CF) is valid only for 
unlabeled tapes. 



Function was rejected (possible hardware 
problem). 

The first word address parameter was 
greater than the last word address 
parameter on DHP, DMD, DHPECS, DMDECS, LOC, 
or PBC command or DMP, DMD, DED, or DEP 
system requests. 

Either first word address parameter of LOC 
or the last word address of LOC or PBC was 
greater than or equal to your field length. 

The table generated by the GETFNT macro is 
too large to fit in the job's field length. 

The HTIME command or macro is valid only on 
a model 176. 

Your job issued a CIO function not allowed 
on an execute-only file. 



Action was requested on a local file that 
was busy. 



You attempted to perform a function on a 
local file before another function on the 

same file was complete. 



Your have specified a level outside of the 
equipment access level limits. 



Copy file to mass 
storage and retry. 

Reduce length of file or 
save as a direct access 
file. 



Reduce the length of the 
file or ask site 
personnel for a larger 
direct access file 
length limit. 

Increase job step 
extended memory field 
length. 

Rerun the job with 
larger field length 
specification. 

None. 



Return some files and 
retry operation. 



The tape must be 
assigned as an unlabeled 
tape. 

Inform site analyst. 
Correct error and retry. 



Reduce FWA and/or LUA 
and retry. 



Specify larger GETFNT 
table size. 

None. 



Attach file in proper 
mode to allow the 
desired operation. 

Write a PSR. 



Modify program to wait 
until each function is 
complete before 
attempting another. 

Use access level within 
required equipment's 
access level limits, or 
use equipment with 
access level required. 



1AJ 



1MS 



1MA 



1AJ 
1AJ 



1AJ 



RESEX 



1MT 



CPMEM 



CPMEM 



LFM 



1AJ 



1MS 



LFM 
PFM 
1AJ 

1MS 



RESEX 
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MESSAGE 



IMPROPER ACCESSIBILITY. 



INCORRECT APPLICATION ACCOUNTING REQUEST. 



INCORRECT COMMON MEMORY MANAGER REQUEST. 



SIGNIFICANCE 

You did not specify the correct file 
accessibility on the LABEL command or 
macro, or volume accessibility was set and 
you attempted to assign the tape as 
unlabeled from a nonsystem origin job. 

The application program that issued this 
message attempted to initiate application 
accounting incorrectly. 

A memory request was issued with reserved 
bits in the parameter block set. 



ACTION 

Ensure accuracy of 
request. 



Inform data base 
administrator. 



Do not set reserved bits. 



ROUTINE 
RESEX 



CFM 



1MA 



INCORRECT DEVICE REQUEST. 



INCORRECT END OF JOB OPTION SPECIFIED. 



INCORRECT EQUIPMENT. 



INCORRECT EQUIPMENT ON FILE filename AT 
address. 

INCORRECT ERROR EXIT ADDRESS. 

INCORRECT EXTERNAL CALL. 
INCORRECT FILE MODE. 

INCORRECT FILE NAME filename AT address. 



INCORRECT FILE STATUS. 
INCORRECT FILE TYPE. 



pfn INCORRECT FILE TYPE. 



INCORRECT I/O REQUEST ON FILE filename AT 
address. 



INCORRECT ID CODE. 



INCORRECT INSTRUCTION. 



INCORRECT LABEL TYPE, filename AT address. 



The device type IR parameter) specified on 
a request for an auxiliary device cannot be 
recognized or does not exist in the 
system. If the auxiliary device specified 
by the PN parameter is not the same type as 

"re a/aiciu ui juD utriauii, liic n pa [ ailic ici 

must be included. 

The option specified is not valid for a 
noninteractive job. 

Equipment specified does not exist or is 
not allowed (for example, an interactive 
teminal is requested from other than 
interactive origin, or a tape is being 
requested with the REQUEST macro). 

A system error. 



Error exit address is beyond the job's 
current field length. 

RESEX did not recognize an external call. 

You tried to unlock a file that was 
attached in execute-only mode. 

The file name does not conform to 
established rules. The file name must have 
a maximum of seven characters, 
alphanumeric, and must be left-justified 
with binary zero fill. 

Specified file status is incorrect. 

The specified file is of a type not allowed 
in the requested operation. Possible 
causes include attempts to 

- Change a nonlocal file to file type 
library. 

- Designate a direct access file as the 
primary file. 

- Route the primary fiie. 

- Change the access level of a nonlocal 
file. 

The operation requested cannot be performed 
on the specified file because it is of the 
wrong file type. This message is issued 
when you attempt to define a direct access 
file with the same local file name as a 
file currently assigned to the job that is 
of a file type other than local. 

The system could not recognize the 
specified function code, or the code was 
not valid for the type of device to which 
the file was assigned. You attempted to 
write on a local file that resides on a 
device whose highest access level is below 
the current access level of your job. The 
system provides a dump of the FET on file 
OUTPUT. 

An identification code not in the range 
0-67B or 77B is present on the LDI command. 



The CPU attempted to execute an incorrect 
or unavailable instruction. 



Incorrect label type. The only valid label 
types are ANSI labeled and nonstandard 
labeled. 



Examine auxiliary aevice 
request and ensure its 
accuracy. 



Retry with a different 
option. 

Ensure that file resides 
on a legal equipment 
type. 



Inform site analyst. 

None. 

Inform site analyst. 
None. 

Use valid file name. 

Check value. 

Verify that file type is 
appropriate. 



CPM 



LFM 
RESEX 



1HS 

1AJ 

RESEX 

LFM 

1MS 



LFM 
LFM 



Define the file using a 
unique name or return 
the conflicting file. 



Verify CIO function code 
being used. Lower the 
access level of your 
job, if possible, or 
raise the access level 
of the file. 



Reissue the request with 
the correct 
identification code. 

Analyze job output and 
dumps to determine the 
cause of the error. 

Use correct label type. 



PFM 



1MS 



LDI 



1AJ 



1MT 



60459690 D 



B-11 



INCORRECT LOAD ADDRESS. 

INCORRECT MODIFICATION OF filename AT address. 

INCORRECT RANDOM ADDRESS. 
INCORRECT USER ACCESS. 

INCORRECT USER COMMAND. 



INDEX ADDRESS OUT OF RANGE FOR filename AT 
address. 



INDEX TOO LARGE ON OPEN, FILE filename AT 
address. 



INPUT FILE IN NO RERUN STATUS. 
INPUT FILE IN RERUN STATUS. 
INSUFFICIENT RESOURCES ON SYSTEM. 

INTERLOCK NOT AVAILABLE, 
pfn INTERLOCKED. 

INVALID FILE ACCESS LEVEL. 

pfn IS DIRECT ACCESS. 

filename IS EXECUTE ONLY. 

pfn IS INDIRECT ACCESS. 

ITF, CONNECTING TO HOST pid. 
JOB CANNOT ACCESS FILE. 

JOB CARD ERROR (jobcmmnd) 

JOB HUNG IN AUTORECALL. 

JOB IN NORERUN STATE ON RECOVERY. 

JOB NOT RERUN. 

JOB REPRIEVED. 
JOB RERUN. 



SIGNIFICANCE 



The Ipad address is less than 2. 



Either you have attempted to shorten a 
modify-only file or the file cannot be 
modified at all. 

The current random address specified is 
zero. 

You are not authorized to access a 
restricted subsystem without proper 
validation. 

The user name or password could not be 
validated, or a secondary USER command 
to a different family was attempted, and 
you are not validated to change families. 

The random sector address for a random 
input/output request was equal to or 
greater than the job's field Length. 

For an OPEN function, the random index 
length exceeded the index buffer size. 



Informative message. 

Informative message. 

Resource demand exceeds the number of units 
physically available on the system. 

A software interlock is currently not 
available to the requesting function with 
both ep and up processing options specified. 

The file is currently not available for 
WRITE, MODIFY, UPDATE, or APPEND modes of 
access because a system utility has 
attached the file in utility mode. 

The access level specified in the FET for 
an LFH request is not valid for that user, 
or for the equipment on which the file 
resided. 

An indirect access fiLe operation was 
attempted on a direct access file. 



The specified local file cannot be accessed 
by SAVE, REPLACE, APPEND or DEFINE since it 
is an execute-only file. 

A direct access file operation was 
attempted on an indirect access file. 



Indicates state of connection to host pid. 

The permanent file being processed has 
either an access level or access categories 
that are not valid for your job. 

The Job command of a routed job contains an 
error, jobcmmnd is the first 20 characters 
of the Job command in error. 

The address to which the job was recalled 
does not have the complete bit set, and 
there is no system activity outstanding 
that could set the complete bit. 

Identifies a job recovered on Level or 
level 3 deadstart that was aborted because 
it was in a no-rerun mode (due to NORERUN 
command or macro). 

The system was unable to successfully rerun 
a job because of a mass storage read error 
or because the QFT is full. 

The job has been successfully reprieved. 

The job has been terminated and requeued 
for input. 



ACTION ROUTINE 

Specify larger load 1AJ 

address and retry. 

Determine whether file 1MS 
can be modified. 



Verify current random LFM 
address. 

Determine proper EXINIT 

validation requirements. 



Verify that user name and CPM 
password are valid. 



Correct random sector 1MS 
address. 



Set EP bit in FET+1 to 1MS 
get error status without 
abort or increase index 
buffer size. 



None. 


Q.FM 


None. 


QFM 


Reduce resource demand. 


RESEX 


Retry function at a 


PFM 


later time. 





Retry operation later. 



Correct the access level LFM 
and retry. 



Use the appropriate PFM 

direct access file 

request. 



None. 



Use the appropriate PFM 

indirect access file 

request. 

None. ITF 

None. Your job can not PFM 
access the file. 



Correct the Job command 
and retry. 



Analyze job and dumps to 1AJ 
determine cause. 



Refer to the NORERUN 1AJ 

command or macro 

description. 



Resubmit the job to the 1AJ 

system. 



None. 1AJ 

None. 1AJ 
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MESSAGE 
JOB STEP EXCEEDS ACCOUNT BLOCK. 

JOB STEP LIMIT. 

LABEL CONTENT ERROR, filename AT address. 

LABEL MISSING, filename AT address. 
LABEL NOT EXPIRED. 



LABEL PARAMETER ERROR ON OPEN, filename 
AT address. 



LFM DETECTED ERROR. 



LFM ERROR. 



LFM INCORRECT REQUEST. 



LOADER MISSING. 
LOCAL FILE LIMIT. 



M.T. NOT AVAILABLE ON FILE filename AT 
address. 

MAGNETIC TAPE SUBSYSTEM NOT ACTIVE. 



MASS STORAGE ERROR. 



MESSAGE LIMIT. 



"FL LESS THAN EXTENDED MEMORY MINIMUM CM FL. 



MISSING DEMAND FILE ENTRY. 



SIGNIFICANCE 

You tried to set your job step limit to a 
value greater than your account block limit 
or tried to set your account block limit to 
a value less than your job step limit. 

The monitor detected the espiration of the 
job step SRU limit. 



A block read was the correct size for a 
label but one or more required fields (such 
- as the label name) were incorrect. 

During a read operation, a required label 
was missing. 

You attempted to write on a tape with an 
unexpired label. 



Label fields did not match on open 
request. An additional message, 

FIELD BEGINNING AT addr NO COMPARE, 
specifying the decimal character position 
in HDR1 of the first field that did not 
compare correctly, is also issued. 

Issued before one of the following errors. 

- OVERLAY NOT FOUND IN LIBRARY. 

- ARGUMENT ERROR. 

The Resource Executive (RESEX) detected an 
error. 

LFM detected an error in the request. See 
other error messages in dayfile for more 
information. 

One of the following: 

- The function detected was not recognized 
as a valid LFM function. 

- An LFM function was issued without the 
auto recall bit set. 

1AJ could not find BEGIN or LDR=. 

The job tried to create too many local 
files. 



The magnetic tape executive is not 
executing. 

One of the following occurred during a 
magnetic tape request. 

- There was no UDT address in the FST. 

- The UDT address in the FST was incorrect. 

- The MA6 subsystem was not present. 

An error was encountered in reading a 
portion of the permanent file catalog or 
permit information (error log and dayfile 
message). This indicates a hardware 
problem with a disk pack or disk drive. 



The number of messages issued by the job 
has exceeded the limit for which you are 
authorized. Message functions issued by 
compilers or applications that run in the 
job's field length are also counted as job 
dayfile messages and thus are subject to 
your dayfile message limit. 

To use extended memory you must have a 
required minimum amount of central memory 
field length. This message indicates that 
you do not have the required central memory 
field length. 

Dayfile message indicating a RESEX internal 
problem. The overcommitment algorithm was 
initiated without a demand file entry 
having been defined previously. 



ACTION ROUTINE 

Check values on SETJSL CPM 
and SETASL commands. 



Reset job step limit 1AJ 
with SETJSL command or 
macro and retry. If job 
step SRU limit is set at 
maximum, request 
increased SRU validation. 

Use LISTLB command to 1MT 

obtain Label data and 

retry. 

Ensure that tape has 1MT 
LabeL, 

If current contents of 1MT 

tape can be sacrificed, 

have operator blank 

label tape. Otherwise, 

wait until label has 

expired. 

Use LISTLB command to 1HT 
obtain label data. 



Correct error and retry. 



Inform site analyst. LFM 



Ensure that a valid LFM 
request is being made. 



Verify that a valid LFM 
request is being used. 



Inform software support. 

Reduce local file usage 
or see site administrator 
about changing your 
validation Limits. 

Inform site operator. 
Bring up MAGNET. 

Contact site operator 
to have MAGNET 
brought up. Otherwise 
contact central 
software support. 

Inform site analyst. If 
many of these errors 
occur, the site anlayst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 

Split job into two or 
more jobs and retry. 



Increase central memory 
field length. 



Inform site analyst. 



LFM 



LFM 



1AJ 
1AJ 



1MS 



LFM 
RESEX 



PFM 



1AJ 



IMA 



RESEX 
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MESSAGE 
jsn HISSING RESOURCE. 



HISSING VSN OR EaUIPHENT ASSIGNMENT. 



HLF REQUEST TOO SHALL, MINIMUM USED. 



MONITOR CALL ERROR, xxxx nnnrmnnnn. 



HT,Cce,Eec,Hhhhhhhhh,B.C. RESTART. 
HT,Ccc,Eec,Hhhhhhhhh,BAD ERASE. 
HT,Ccc,F.ec,Hhhhhhhhh,BID RECOVERY-x. 

MT,Ccc,Eec,Hhhhhhhhh,BLOCK TOO LARGE. 

MT,Ccc,Eec,Hhhhhhhhh,BUSY. 
HT,Ccc,Eec,Hhhhhhhhh, CHANNEL ILL. 

HT,Ccc,Eec,Hhhhhhhhh,CON. REJ. 

MT,Ccc,Eec,Hhhhhhhhh,CON. REJ. MDI. 

HT,Ccc,Eec,Hhhhhhhhh,CON. REJ. OFF. 
WT,Ccc,Eec,Hhhhhhhhh,FNffff,Pyyyy. 

MT,Ccc,Eec,Hhhhhhhhh,Lbbbb,Bnnnnnn. 

MT,Ccc,Eec,Hhhhhhhhh,LO*e CHECK. 
HT,Ccc,Eee,Hhhhhhhhh,HARGINAL, DOWN. 
NT,Ccc,Eec,Hhhhhhhhh,MARGINAL, OFF. 

MT,Ccc,Eec,Hhhhhhhhh,NO EOP. 

HT,Ccc,Eec,Hhhhhhhhh, NOISE. 
HT,Ccc,Eec,Hhbhhhhhh,NOT READY. 
HT,Ccc,Eec,Hhhhhhhhh,ON THE FLY. 



SIGNIFICANCE 

Dayfile message indicating that a RESEX 
internal problem occurred. RESEX expected 
but did not find a resource unit assigned 
to the job yith job sequence number jsn. 
This could occur if the HAG subsystem was 
stopped while tapes were assigned. 

Dayfile message indicating internal 
malfunction in RESEX (expected VSN or 
equipment assignment was not found). 

The SETHFL macro CCPH function 52) 
attempted to specify a maximum FL value 
lower than the minimum required for a 
subsequent HFL command. 



One of the following occurred during the 
processing of an monitor request: 

- The monitor request call was not 
recognized by the system. 

- Bad parameters were supplied in the 
request . 

- Incorrect user access was encountered. 

- An incorrect request was included in the 
request . 

Magnetic tape controller controlware 
restarted. 

Error detected after an erase was attempted 
to recover a write error. 

A single block mispositioning error was 
recovered by block ID recovery. If x is B, 
the error was caused by backspacing the 
tape too far; if x is F, the tape was not 
backspaced far enough. 

Data block is at least one byte longer than 
length bbbb shown in third line of message. 

Unit was still busy after one second. 

Channel is not accepting function for 
status requests properly. 

Connect reject; unable to connect to the 
unit. 

Connect reject; unable to connect to unit 
because of marginal detection indication 
(thermal warning). Unit turned off. 

Connect reject; unable to connect to unit. 
Unit turned off. 

Function ffff was rejected by the 
controller; yyyy is the address in 1HT 
where the function was initiated. 

The length (bbbb) and block number (nnnnnn) 
read from trailer bytes in block did not 
match the actual length or the block number 
read given in previous message line. 

Load sequence failed on the unit. 



Indicates controller failure. Channel has 
been logically turned off and maintenance 
is required. 

Unit has been logically turned off because 
of read/write failure. This occurred when 
a special function to check the read/write 
path to a unit failed during initial label 
scan. Haintenance is required. 

No end-of-operation detected from unit 
within 1 second. 

A noise block was skipped on the tape. 

Tape unit dropped ready status. 

Error was corrected as the data was read. 



ACTION ROUTINE 



Inform site analyst. RESEX 



Inform site analyst. RESEX 



No action necessary. To CPH 
prevent the message from 
recurring increase HFL 
specified in SETHFL 
macro to at least the 
minimum required for the 
HFL command. 

Examine program to 1AJ 

determine why incorrect 
monitor request call is 
being made. 



None. 1HT 

Inform site analyst. 1HT 

None. 1HT 

None. 1HT 

Inform customer engineer. 1HT 

Inform customer engineer. 1HT 

Inform site analyst. 1HT 

Inform customer engineer. 1HT 

Inform site analyst. 1HT 

Inform site analyst. 1HT 

None. 1"T 



Push CLEAR button and 1HT 
reload tape, or inform 
site analyst. 

Inform customer engineer. 1HT 



Inform customer engineer. 1HT 



Inform customer engineer. 1HT 

None. 1NT 

Hake unit ready. 1HT 

None. 1HT 
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MESSAGE 
MT,Ccc,Eec,Hhhhhhhhh, POSITION LOST. 

MT,Ccc,Eec,Hhhhhhhhh, RECOVERED. 

«.T,Ccc,Eec,Hhhhhhhhh, STATUS. 

nT,Ccc,Eec,Hhhhhhhhh,WRONG PARITY. 



"T,Ccc-e-uu,vsn,rw,est,Ss,GSgggggggg 

MT,Ccc,Dddd...d. 

NT,Ccc,Uuu...u,Ttttt. 

MT,Ccc,Aaaaaaaaa. 

r!T,Ccc,Fff,Iii,8nnnnnn,Lbbbb,Ppppppppp. 

BT.Ccc.Eec.Hhhhhhhhh.type. 

or 
NT,Ccc-e-uu,vsn,rw,est,Ss,GSgggggggg. 
MT,Ccc,Dddd...d. 
nr,Ccc,Aaaaaaaaa. 

WT,Ccc,Fff,Iii,Bnnnnnn,Lbbbb,Ppppppppp. 
WT,Ccc,Eec,Hhhhhhhhh,type. 

or 
NT,Ccc,-e-uu,vsn,rw,est,Ss,GSgggggggg. 
WT,Ccc,Dddd...d. 

MT,Ccc,Fff,Iii,Bnnnnnn,Lbbbb,Ppppppppp. 
MT,Ccc,Eec,Hhhhhhhhh,type. 

or 
HT, C cc-e-uu,vsn, rw, est , Ss,GSgggggggg . 
MT,Ccc,Dddd...d. 
»T,Cce,Uuu...u,Ttttt. 
MT,Ccc,Fff,Iii,Bnmnnn,Lbbbb,Ppppppppp. 
WT,Ccc,Eed,Hhhhhhhhh,type. 



SIGNIFICANCE 

The Last good block written cannot be found 
during write recovery. 

Previously reported error has been 
successfully recovered. 

Error type cannot be determined so actual, 
controller status is returned. 

Tape was written in parity opposite that 
being read. 

Four or five or six-line message describing 
a magnetic tape hardware malfunction on a 
66x or 67x tape unit. Message as 
illustrated indicates 7-track, model 667 or 
677 unit. If NT appears in place of HT, 
message indicates 9-traek- model 669 or 679 
unit. Message is issued to error log and 
dayf ile. 

The first line of each message provides the 
following information. 

cc-e-uu Channel, equipment (tape 
controller), and physical 
unit number of tape unit on 
which error was encountered, 
vsn Volume serial number 

associated with tape on the 
specified unit, 
rw Read CRD) or write <WR) 

operation; any operation not 
involving an actual read or 
write is listed as a read, 
est EST ordinal of the unit on 
which the tape was written. 
This is provided only for 
labeled tapes generated 
under NOS; otherwise, the 
field is blank, 
s Channel status, 
gggggggg General status of magnetic 
tape unit. Last byte is 
block ID. 
The MT,Ccc,Dddd. ..d line of the message 
provides the following information. 

cc Channel number; the channel 
number is repeated to allow 
the analyst to associate this 
message with the first message 
if errors are occurring on 
more than one tape channel 
at the same time. 
ddd...d Detailed status of magnetic 
tape unit. 
The RT,Ccc,Uuu...u,Ttttt line of the 
message provides the following information, 
cc Channel number; repeated to 
associate this message with 
the previous message. 
Detailed unit status. 
Third byte of the tape unit 
format parameters (refer to 
the magnetic tape subsystem 
reference manual for 
descriptions of unit format 
parameter fields). 
The MT,Ccc,Aaaaaaaa Line (for FSC only) 
contains the additional sense byte 
status not placed in the detailed status 
or unit status fields. 

cc Channel number, 
aaaaaaa Sense byte. 

The HT,Ccc,Fff,...,Ppppppppp line of the 
message provides the following information, 
cc Channel number; repeated to 
associate this message with 
the previous message. 
Software function on which 
the error occurred. 
Error iteration; number of 
times error has been 
encountered on this unit 
without successful recover/. 
Block number on which error 
occurred. 

Length of block on which 
error occurred in octal 
bytes. 

1HT internal error 
parameters. 



ACTION 



UU...U 

tttt 



ff 



None. 



None. 



ROUTINE 

1MT 



1MT 



Inform site analyst. 



Refer to the separate 
listing of the last line 
message CMT,...,type.) for 
the appropriate action. 



1HT 



1MT 



bbbb 



pppppppp 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



"T/NT CONFLICT. 



MULTI-FILE NOT FOUND, filename AT address. 



NO EXTENDED MEMORY. 

NO INPUT FILE FOUND. 

NO MASS STORAGE AVAILABLE. 

filename - NO TEMP DEVICE FOUND. 



NO WRITE ENABLE, filename AT address. 



N0N-MATCHIN6 CONVERSION. 



NON-MATCHING DENSITY. 



ec 

hhhhhhhh 



type 



The last line of each message provides the 

following information. 

cc Channel number; repeated to 
associate this message with 
the previous message 
Octal error code value. 
Parameters passed to the 
tape unit for the format 
function (refer to the tape 
drive's hardware reference 
manual for descriptions of 
the unit format parameter 
fields). 

Additional description of 
the error. Refer to 
individual listing of the 
last line message. 

Conflict exists between 7-track and 9-track 
tape descriptors (track type, density, and 
conversion mode). For example, a request 
for a 9-track tape specified 200 bpi 
density. This message can also be issued 
if the device type specified in FET+1 
conflicts with the track type specified in 
bit 56 of FET+10 octal. If dt=NT and bit 
56 is set, the message is issued. 

Either LISTLB has reached the end of the 
multifile set or the requested file was not 
found. The following additional messages 
are also given. 

- REQUESTED SECTION xxxx. 

- FOUND SECTION yyyy. or 

- FILE IDENTIFIER NOT FOUND. 

The filename, address, xxxx, and yyyy given 
can be ignored. 



A DMPECS or DNDECS command or DED or DEP 
request was entered and no extended memory 
field length is assigned to you. 

No valid input file exists; functions 
cannot be performed. 

No mass storage space of the requested 
type could be found. 

You attempted to create a local copy of an 
indirect access permanent file, but the 
file's access level was not within the 
range of valid access levels for any active 
temporary storage device. 



Either you attempted to write on a tape 
mounted with no write ring, or no write was 
allowed because of additional constraints 
described in an additional message line. 
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Informative message indicating conversion 
mode on labeled 9-track tape differs from 
that specified by assignment request. 
System writes tape in specified mode, or 
reads tape with write ring out in correct 
mode. However, reading tape with write ring 
in or using wrong conversion mode generates 
conversion errors. 

Informative message indicating that the 
density specified on the command or macro 
is not the same as the density of the 
assigned tape. Issued only to 9-track 
tapes with write ring out. 9-track tapes 
are read at the current density on tape. 
They are written at specified density if 
write initiated from load point; otherwise, 
tape is written at the current density on 
the tape. 



Ensure accuracy of 
command. 



If LISTLB reached the 
end of the multifile 
set, the operation is 
complete and no action 
is required. Otherwise, 
ensure that the correct 
tape is being used and 
that it contains the 
desired file(s). All 
label parameters must 
match in order to 
position to the 
specified file. 

None. 



Verify that input fiLe 
is present. 



Retry later. 



Inform security 
administrator. The 
security administrator 
needs to configure the 
system so that temporary 
devices are available 
for all valid access 
levels. 

If no additional message 
line appears, ensure the 
inserting of a write 
ring by specifying the U 
processing option on the 
tape request (for 
example, P0=U on the 
LABEL command). 
Otherwise, refer to the 
description of the 
message in the 
additional message line. 

If reading tape with 
write ring in, return 
and reassign with 
correct conversion mode. 



None. 



RESEX 
BLANK 



1MT 



CPNEM 



PFH 



1HT 



RESEX 
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MESSAGE 

NORERUN/RERUN INCORRECT FROM INTERACTIVE 
JOBS. 



filename NOT FOUND. 

or 
user-name NOT FOUND. 



filename NOT IN WRITE MODE. 

' i (.enafiie NOT OK MASS STORAGE. 

filename NOT ON MASS STORAGE. 

NOT VALID TO DOWNGRADE DATA. 

NOT VALIDATED FOR REQUESTED ACCESS LEVEL. 

NOT VALIDATED FOR WRITING UNLABELED TAPES. 

NOT VALIDATED TO SET XD/XT. 

ONLY CORRECT PARAMETERS ARE *ON* OR *OFF*. 
OPERATOR DROP. 
OPERATOR KILL. 

OPERATOR OVERRIDE. 

OVERLAY FILE EMPTY. 

OVERLAY FILE NOT FOUND. 

OVERLAY LOST. 
OVERLAY NOT FOUND. 

OVERLAY NOT FOUND IN LIBRARY - ovlname. 
PARAMETER BLOCK BUSY. 

PARAMETER *ON* OR *OFF* REQUIRED . 



PARAMETERS *ON* AND *OFF* ARE MUTUALLY 
EXCLUSIVE. 



SIGNIFICANCE 

You entered a NORERUN or RERUN command -from 
an interactive terminal. The command is 
ignored. 

One of the following: 

- The specified permanent file could not 
be found. 

- The specified user name could not be 
found. 

- You are not allowed to access the 
specified file. 

- The specified local file could not be 
found. 

The file specified in an OVWRITE command or 
macro was not processed because you do not 
have write access to it. 

The file to be saved is not on mass 
storage; the first track of the file is not 
recognizable. 

The file specified in an OVWRITE command or 
macro was not processed because it does not 
reside on mass storage. 

You attempted to lower the access level of 
a permanent file, but you are not validated 
to downgrade files. 

User has specified an access level outside 
the user's access level validation. 



User has not been validated for writing on 
unlabeled tape. 



You specified an XD or XT parameter in a 
CHAN6E, DEFINE or PERMIT command or macro 
without having validation to use these 
parameters. 

The parameter you specified was not 
recognized. 

Informative message indicating that the 
operator dropped the job. 

The operator entered a KILL command to drop 
the job. This disallows erexit 
processing. A job with extended reprieve 
processing is reprieved once. Exit 
processing is allowed. 

The operator entered an OVERRIDE command to 
drop the job. This disallows exit, erexit, 
and reprieve processing. 

No data appears in the requested file. 



ACTION 



None. 



ROUTINE 



QFM 
CONTROL 



PARITY ERROR, JOB HUNG. 



The specified file was not available. 

The specified overlay was not found. 

The specified overlay was not found. 



The overlay ovlname was not found in the 
system library. 

The completion b't of the parameter block 
was not set to one before the monitor 
request was made. 

No parameter was specified on ERRHSG 
command. 

You specified both the ON and OFF 
parameters on the same command. Only one 
is allowed. 

A CM parity error occurred in the jobs 
field length. The job is hung to freeze 
the affected area. 



Verify that file name/ 
user name is correct, 
that access permission 
has been granted, and 
that correct access is 
being attempted. 



Correct and retry. 



Verify that file is 
mass storage. 



Correct and retry. 



None. 



Use a validated access 
level, or site must 
validate user for 
additional access level. 

Either use labeled tape 
or site must validate 
user for SAV=CULT MODVAL 
privilege. 

Retry without XD or XT 
parameter, or obtain 
validation and retry. 



Check command 
description and retry. 

None. 



Correct job as needed 
and rerun. 



Correct job as needed 
and rerun. 



Verify that overlay file 
is valid. 

Verify that file is 
local to job and retry. 

Inform software support. 

Verify that the file 
with the specified 
overlay is local to the 
job. 

Verify that call is to 
valid overlay. 

Set completion bit 
before making monitor 
request call. 

Retry with a parameter. 



Retry with either ON or 
OFF. 



Inform software support. 



PFM 



IMS 



IMS 



PFM 



RESEX 



RESEX 



CONTROL 



1AJ 



1AJ 

1AJ 

1AJ 

1AJ 

1AJ 
1AJ 



-FM 



CONTROL 



CONTROL 



1AJ 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



pfn PERMANENT ERROR. 



The specified direct access file resides on 
alternate storage and has data errors that 
must be corrected. The error flag must be 
cleared or the file must be reloaded from a 
backup copy. 



Inform site analyst. 
The site analyst may 
be able to correct the 
problem with ASDEBUG or 
SSDEBUG; otherwise, the 
file must be purged or 
reloaded. 



PFM 



PERMIT LIMIT EXCEEDED. 



PF STAGING DISABLED. 



A PERMIT command or macro cannot be 
processed because the file specified 
already has the maximum number of permits 
allowed. 

The specified direct access file cannot be 
accessed since it resides on the Mass 
Storage Facility (MSF) and the site has 
temporarily disabled all MSF file staging. 



None. 



Determine from site 
operator when MSF file 
staging will resume and 
retry the job at that 

time. 



PFM 



PFM 



PF UTILITY ACTIVE. 



The operation was not attempted because a 
permanent file utility was currently active. 



Wait until PF utility is 
not active and retry. 



PFM 



PFM ARGUMENT ERROR. 



One of the following conditions is true: 

- The PFM call block is outside of the 
job's field length. 

- An incorrect command code was specified. 

- Auto recall was not set when PFM was 
called. 



Correct your program 
to call PFM properly. 



PFM 



PFM EXCESS ACTIVITY. 



PFM INCORRECT REQUEST. 



PL ERROR IN DECK. 



POSITION ERROR ON-filename. 



POSITION LOST, filename AT address. 



PP CALL ERROR. 



PRIOR TAPE ASSIGNMENT LOST. 



PROGRAM STOP. 



PROGRAM STOP AT address. 



PRU LIMIT. 



The PFM activity count for your permanent 
file family is currently at its limit. 
This condition is reported to the 
requesting program only if both ep and up 
processing options are set. 

One of the following occurred: 

- A privileged command was requested by a 
nonvalidated program. 

- An incorrect backup requirement, 
preferred residence* or subsystem value 
was entered. 

- Incorrect command code, passed to PFM. 

- Incorrect permit mode or catalog type 
specified. 

- The FET for a file specified in a 
SETPFAC request was less than six words 
long. 

The program library specified by the P 
option in the KRONREF command was 
incorrectly formatted. 

File filename was not repositioned after 
being checkpointed because CHKPT detected 
an address error. 

During write or read error recovery, the 
system could not find the last good block 
of data, making it impossible to 
successfully perform error recovery. 
Labels are not written after this error and 
existing data on the tape is not destroyed. 

The monitor detected an error in a CPU 
request for PP action. 

Magnetic tape executive has been dropped 
along with tapes assigned. All of the 
job's prior tape assignments are lost. 



The system processed a program stop (00) 
instruction. 

The monitor detected a program stop 
instruction at the specified address. 

The job's mass storage PRU Limit was 
exceeded during preparation of a local copy 
of an indirect access file. 



Retry operation later. 



Verify that the PFM 
request is valid. 



Check that the PL 
MODIFY OPL. 



None. 



Retry operation on 
different tape or tape 
drive, if possible. 



Verify that correct PP 
call is issued. 

From an interactive job, 
return/unload all prior 
tapes and reassign. A 
batch job aborts and 
must be rerun. 

None. 



None. 



Return one or more local 
files and retry. 



PFM 



PFM 



1MT 



1AJ 



RESEX 



1AJ 



1AJ 



PFM 



PRU LIMIT, FILE filename AT address, 



PRUS REQUESTED UNAVAILABLE. 



The job's mass storage PRU limit was 
exceeded during an attempt to write or 
extend this file. 

On a DEFINE, no device currently has 
available the amount of space requested by 
the S parameter. On a secured system, no 
device with the proper access level 
currently has the amount of space requested. 



Return one or more local 
files and retry. 



If possible, reduce the 
number of PRUs specified 
by the S parameter, or 
retry at another time 
when space might be 
available. 



IMS 
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MESSAGE 
OAC BUFFER ARGUMENT ERROR. 

8AC INCORRECT PARAMETER BLOCK SIZE. 
QAC INCORRECT QUEUE ORDINAL. 

QAC INCORRECT REQUEST. 



OAC REQUEST COMPLETION BIT SET. 
QFM ARGUMENT ERROR. 

8FM BUFFER ARGUMENT ERROR. 

QFM FILE NAME ERROR. 
QFM I/O SEQUENCE ERROR. 
QFM INCORRECT EQUIPMENT. 

QFM INCORRECT QUEUE FILE ORDINAL. 

QFM INCORRECT REQUEST. 

QFM USER ACCESS NOT VALID. 



RANDOM ADDRESS NOT ON FILE filename AT 

address. 



RANDOM INDEX ERROR. 



READ AFTER WRITE, filename AT address. 



READY DROP, filename AT address. 



SIGNIFICANCE 

The address in one of the QAC buffer fields 
(first, in, out, or limit) is incorrect. 



The value of the len field of address+1 is 
incorrect for the requested function. 

The ordinal in the ejt/qft ord field of 
address+4 is out of range for the specified 
queue. 

One of the following occurred: 

- In i in^a* ; ma.4 4. .»_«- : _.. -_J- * I 

™. u., wu i iiigu lUMbllWI lfl^4C maS CIILCICU 

in address+0. 

- An incorrect address was entered in 
monitor request or the link address 
field in address +108, on the QAC 
parameter uicck. 

- The range of security access levels 
specified was not within the job's 
security access Level limits. 

- The new security access level specified 
in an ALTER request was not within the 
security access level limits for the 
file's origin type, or is not allowed on 
the device where the file resides. 

- An ALTER request to change the access 
level of a queued file was made by a 
user without security administrator 
privileges. 

The completion bit in address+0 was set for 
the request. 

One of the following: 

- Address is outside field length. 

- Address is equal to 1. 

- Origin code is out of range. 

- ID code is out of range. 

A buffer pointer did not conform to the 
following constraints. 

- FIRST .LE. IN 

- FIRST .LE. OUT 

- OUT .LE. LIMIT .LE. FL 

The filename specified is not a valid file 
name. 

Action was requested on a busy file. 

The equipment specified in FET+7 either is 
not mass storage or is not in the range of 
the EST. 

The QFT ordinal of the file to be attached 
is out of range. 



One of the following. 

- Specified function was incorrect or 
undefined. 

- Job did not have SSJ= entry point. 

- Auto recall bit was not set. 

The user tried to perform an operation for 
which he is not validated Cfor example, 
attempting to run a system origin job from 
nonsystem origin). 



The random address specified was not within 
the bounds of the file. The system 
provides a dump of the FET on file OUTPUT. 

The random disk address of the permit 
sector is in error '.error log and dayfile 
message). This may be a problem with 
your program. 

You attempted to read a tape on which the 
last operation was a write. 



ACTION 

Ensure that all four 
addresses are within the 
job's field length. 

Correct the len field or 
the function code. 

Enter a valid EJT or QFT 
ordinal. 



Enter a valid function 



ROUTINE 
QAC 



QAC 



QAC 



or access. 



Unit dropped ready status. 



Clear the completion bit. 



Verify that QFM request 
is valid. 



Examine program to 
determine error in 
buffer pointers. 



Verify file name. 



Wait until file is not 
busy and retry. 

Verify that correct 
equipment is specified 
in FET+7. 

Ensure that the routine 
calling QFM supplies the 
correct ordinal. 

Verify that valid QFM 
request is being made. 



Ensure accuracy of 
command or macro or 
determine proper 
validation 
requirements. 

Verify that random 

address is correct. 



Check your program. If 
it does not use the 
CATLIST macro, inform 
site analyst. 

Ensure accuracy of tape 
positioning commands 
(BKSP, BKSPRU, SKIPFB, 
or REWIND required to 
read after write). 

None. 



QAC 



QFM 



QFM 



QFM 



QFM 



QFM 



QFM 



1MS 



PFM 



1MT 



1MT 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



REPLACE ERROR. 



REPRIEVE BLOCK ERROR. 



REPRIEVE CHECKSUM BAD. 



REQUEST *K* DISPLAY. 



REQUEST UNDEFINED ON DEVICE, filename AT 
address. 



RESEX ABORT - OPERATOR TERMINATION. 



RESEX ABORT - SYSTEM RESOURCE LIMIT. 



RESEX ABORT - TERMINAL INTERRUPT. 



RESEX FAILURE. 



RESOURCE ENVIRONMENT ERROR. 



RESOURCE NEGATIVE SHARE COUNT. 



RESOURCE PF ERROR ec filename. 
RESOURCE SCRATCH FILE ERROR. 



RFL BEYOND MFL. 



ROLLOUT FILE BAD. 



RPV-ADDRESS OUT OF RANGE. 



RPV-CALLED WITHOUT AUTO-RECALL. 



The same file was found twice during a 
catalog search. This error can occur for 
APPEND or REPLACE commands or macros after 
a file is found and purged and the catalog 
search is continued (error log and dayfile 
message). 



An address is out of range or there is an 
incorrect parameter in the reprieve 
parameter block at the time of an error. 
The message is also issued if the specified 
reprieve address itself is out of range. 
(1AJ issues this message for all errors 
except terminal interrupts processed by 
1RI.) 

The computed checksum does not agree with 
the checksum specified in the parameter 
block at the time of the error. (1AJ 
issues this message for all errors except 
terminal interrupts processed by 1RI.) 

Issued by function 5 (Set Console Display 
Register) to DSD B and J displays when 
operator action is requested. 

The specified function cannot be performed 
on the device on which the file resides. 
The system provides a dump of the FET on 
file OUTPUT. 

The operator entered a DROP, KILL or RERUN 
command, setting an error flag in RESEX. 
RESEX performed appropriate cleanup 
procedures before termination. 

RESEX terminated prematurely due to job 
time limit, SRU limit, or track limit. 
kESEX performs appropriate cleanup 
procedures before termination. 



Terminal user interrupted RESEX (interrupt 
or terminate sequence). RESEX performs 
appropriate cleanup procedures before 
termination. 

The resource executive (RESEX) has detected 
a fatal error. 

Dayfile message indicating RESEX internal 
problem occurred (internal environment 
building failed due to HST, UDT, or EST 
errors). 

Dayfile message indicating that a RESEX 
internal problem occurred. The resource 
overcommitment algorithm indicates a 
greater number of users are sharing a 
removable pack than are actually sharing 
the pack. 

PFM error ec occurred when attaching 
resource file filename. 

Dayfile message indicating RESEX internal 
problem has occurred. An empty entry has 
been found in the overcommitment algorithm 
scratch file. 

The RFL request is greater than the maximum 
field length for a job step. 



A job could not be rolled out correctly. 



An address provided to RPV was out of 

range. This includes the following conditions. 

- FHA of parameter block .GE. FL 

- LWA of parameter block .GE. FL 

- Transfer address .GE. FL 

- Transfer address .LT. 2. 

An extended RPV mode call was made without 
auto recall. 



Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 

Ensure parameter block 
is correct. 



PFM 



Ensure interrupt handler 
is still intact. Ensure 
that code in the area 
for which checksum was 
computed has not changed. 

Refer to DSD K display. 



Verify that valid device 
is specified. 



Determine reason for 
operator action. Rerun 
job if possible. 



If error caused by SRU 
or time limit, increase 
resource limits. If 
caused by track limit, 
contact site analyst. 

None. 



Write a PSR. 

Inform site analyst. 

Inform site analyst. 

Inform site analyst. 
Inform site analyst. 



Increase maximum field 
length with MFL command 
or SETMFL macro. 

Inform site analyst. 
Check error log dayfile 
for the job that was 
aborted and the location 
of the bad rollout file. 

Check all addresses sent 
to RPV and ensure that 
they are within range. 



Ensure that auto recall 
bit is set. 



1AJ 



1AJ 



CPM 



1MS 



RESEX 



RESEX 



RESEX 



RESEX 



RESEX 



CPM 



1RI 



RPV 
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SIGNIFICANCE 



ACTION 



ROUTINE 



RPV-INCORRECT CALL. 



^rj-in-.vr.nt^i runuiiwn (.ULib. 



One of the following: 

- An attempt was made to do a reset when 
no previous error existed or the 
previous error was pending. 

- An extended mode call was attempted when 
nonextended RPV or DISTC had already 
been set for the job. 

- A nonextended mode call was attempted 
when RPV extended mode had already been 
set in for the job. 



A call was made to clear extends 
reprieve and there were pending 
interupts present. 



flic lUraCtlGii COu£ Specified I El the 

parameter block was incorrect. 



RPV 



- Check to see if a 
reset is allowed. 

- If RPV nonextended 
mode has already been 
used, then RPV 
nonextended mode 
cannot be used in the 
same job. 

- Clear pending interrupt f 
before calling RPV. 

- If RPV extended mode 
has already been 

.■*»n.J 4-hnn ODU 

nonextended mode 
cannot be used in the 
same job. 

Function COuc in 
parameter block must 
equal 1 for setup, 2 for 
resume, or 3 for reset. 



RPV-INCORRECT PENDING INTERRUPT. 



A bit was set in the pending interrupt word 
of the parameter block which did not 
correspond to a defined error. 



Check parameter block to 
ensure that all bits set 
correspond to a defined 
error. 



RPV 



RPV-INCORRECT PENDING RA+1 RE8UEST. 



The pending monitor request field of the 
parameter block contained an incorrect 
monitor request on a RESUME or SETUP. On a 
RESET, the pending monitor request is not 
validated because the job will not be 
restarted. 



Check pending monitor 
request word in 
parameter block to 
ensure that it contains 
a valid call. 



RPV 



RPV-LWA OF CHECKSUM .LT. FWA. 



The last word address of the checksum was 
less than the first word address. 



Correct and rerun. 



RPV 



RPV-PARAMETER BLOCK TOO SHORT. 



The length specified in the parameter block 
was less than 31B words. 



Ensure that the length 
specified in the 
parameter block is 
greater than or equal to 
31B. 



RPV 



RPV-UNDEFINED MASK. 



The mask specified in the parameter block 
is not a legal mask. 



Check mask set in 
parameter block to 
ensure that it is a 
valid mark. 



SCP INCORRECT TRANSFER ADDRESS. 



The SCP SSCR (RA + 51B) word contains 
incorrect parameters on the completion • 
address for an SF.REGR, SF.SWPI or SF.SMPQ 
function is no longer within the SCP field 
length. 



Correct code error in 
SCP. 



1AJ 



SECURE FILES - CHECKPOINT ABORT. 
SECURE MEMORY, DUMP DISABLED. 



Indicates a local file being checkpointed 
had secure file status set. 

You either attempted to dump memory 
protected by the system, or entered a 
memory dump request after a protected 
command. 



None. 



Refer to Security 
Control in NOS Reference 
Set, Volume 3, or user 
Field Length Dump Request 
Volume 4. 



CHKPT 



1AJ 



SECURITY CONFLICT. 



An attempted operation within the job would 
have resulted in a violation of security 
access levels or categories. The cause is 
described in the immediately preceding 
dayfile message. 



Correct and retry. 



1AJ 



SECURITY VIOLATION ON FILE filename AT 
address. 



One of the following: 

You issued an OPEN request that 
specified an access level for a file 
that is not vaLid for your job. 
You attempted to write on a direct 
access permanent file whose access 
level is lower than that of your job. 



Set the access level of 
the file to the correct 
value and retry. 



1MS 



SFS ARGUMENT ERROR. 



One of the following occurred: 

- The argument passed to SFM was out of 
range or the FET specified did not 
specify a buffer of at least 100B words. 

- The EST ordinal specified is undefined 
in the system. 



Verify that SFM request 
is valid. 



SFM 



SFM BML MESSAGE LENGTH ERROR. 



The specified BML message length is zero or 
greater than six. Legal values for length 
are one through six. 



Specify a valid message 
length. 



SFM 
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MESSAGE 
SFM - DAYFILE BUSY. 
SFM DIRECT ACCESS FILE ERROR. 

SFM DUPLICATE FILE FOUND. 

SFM FILE NAME ERROR. 

SFM FILE NOT ON MASS STORAGE. 

SFM FNT FULL. 

SFM I/O SEQUENCE ERROR. 

SFM INCORRECT DAYFILE CODE. 

SFM INCORRECT EQUIPMENT. 

SFM INCORRECT FILE TYPE. 

SFM INCORRECT REQUEST. 



SFM TRACK INTERLOCK ERROR. 



SFM UNABLE TO INTERLOCK DEVICE. 



SFM - UNCORRECTABLE RMS ERROR. 



isn SHARE TABLE MISMATCH. 



SI CODED FORMAT INCORRECT. 



SL NOT VALIDATED. 



STACK PURGING NOT DESELECTABLE. 



pfn STAGE INITIATED. 



STATUS ERROR, filename AT address. 



STEP CONDITION. 



SUBSYSTEM ABORTED. 



SYSTEM ABORT. 



SIGNIFICANCE 

Action was requested on a busy dayfile. 

An error was encountered in the system 
sector of a direct access file. 

The requested file is already attached to 
the control point. 

The file name, filename, passed through the 
FET is not a valid file name. 

The specified file does not reside on a 
mass storage device. 

A- fast attach file could not be created 
because the FNT was full. 

Action has been requested on a busy file. 



The dayfile code passed in the FET was not 
within range. 

The specified equipment is not in the EST 
or is not mass storage. 

The file must be local for a system file 
and direct access for a fast attach file. 

One of the following occurred: 

- The requested function or origin type 
specified in the function call was not 
recognizable or SFM request was made and 
the auto recall bit was not set. 

- The request required an SSJ= entry point 
or subsystem ID, but none was present. 

Track was either interlocked when it should 
not have been or not interlocked when it 
should have been. 

SFM request was not performed because the 
selected device could not be interlocked. 

An uncorrectable RMS error has been 
detected during an I/O operation. 

Dayfile message indicating that RESEX 
internal problem occurred. While 
processing the job with the specified job 
sequence name. 

An attempt was made to perform a read or 
write operation on an SI tape with the 
coded bit set in the FET. 

The SRU limit requested exceeds that for 
which you are authorized. 

You attempted to change the purging bit 
with the EREXIT function. This cannot be 
done on 6000 or CYBER 70 systems. 

The file does not reside on disk. It is 
currently being staged from alternate 
storage to disk. 

An error was encountered during magnetic 
tape processing. A second message line 
describes the error in more detail. 

Step mode flag set in the PSD register 
caused the program to interrupt at the end 
of a program instruction with an exchange 
jump to EEA (the error exit address in the 
exchange package). 

Your job was connected (either long term 
connection or wait response set) to a 
subsystem which aborted. 

Possible causes include the following. 

- Incorrect USER command. 

- Attempt to access a restricted subsystem. 

- Operator evicted job. 

- Unrecognizable error flag. 

- SSJ= block outside field length. 

- 1RI detected a bad rollout file. 

- 1R0 detected an unrecoverable extended 
memory parity error during rollout of a 
job's extended memory field length. 



ACTION 


ROUTINE 


Inform site analyst. 


SFM 


Inform site analyst. 


SFM 


Specify a unique file 


SFM 


name. 





Specify a valid file 
name. 

Specify a mass storage 
file. 

Retry operation at a 
later time. 

Wait untiL file is not 
busy and retry. 

Inform site analyst. 



Specify a valid mass 
storage equipment. 

Specify a f i le of the 
correct file type. 

Verify that SFM request 
is valid. 



Contact Central Software 
Support . 



Contact Central Software 
Support. 

Contact Central Software 
Support. 

Inform site analyst. 



Resubmit the job with 
binary specified for the 
operation on the SI tape. 

Request smaller SRU 
limit. 

None. 



Wait until stage 
operation is complete. 



Retry or inform site 
analyst. 



Inform site analyst. 



Retry later. 



If the cause was an 
incorrect USER command 
or an attempt to access 
a restricted subsystem, 
correct the job and 
rerun. Otherwise, 
inform a site analyst. 



SFM 



SFM 



SFM 



SFM 



RESEX 



1MT 



CPM 



PFM 



1MT 



1AJ 



1AJ 



1AJ 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



SYSTEM CHECKPOINT ABORT. 



SYSTEM ERROR. 



A subsystem has aborted due to a CHECK 
POINT SYSTEM request initiated by the 
operator. 

A software or hardware system error 
occurred. This message follows a 
more specific message in the 
dayfile. 



None. 



Refer to action for 
the associated 
message. 



1CK 



MODVAL 
PFM 



SYSTEM ERROR. 



eve-rcn cnnftn 



LFM cannot complete the requested LFM 
function because the calling program has 
DMP= entry point. 

Danijacta/j f jjflC'H 1 O" C3f!!"50t feS COIS 1 " 1 letsd 

because the calling program has a DMP= 
entry point. 



Inform siti 


; analyst* 


BLANK 
RESEX 


Support . 


itr-al C n ffu»A 


1 CM 



SYSTEM SECTOR ERROR. 



The system sector of an indirect access 



an 



psrss3nsn , u ■ 1 1@ con 

and dayfile message). This indicates that 

the file has been destroyed. 



Inform site analyst. If 

occur, the site analyst 
should perform a full 
PFDUHP, total INITIALIZE, 
and full PFLOAD on the 
device. 



PFM 



TAPE FORMAT PROBABLY WRONG. 



TIME LIMIT. 



TL NOT VALIDATED. 



TLX - ARGUMENT ERROR. 



TOO MANY PERMANENT FILES. 



This message is issued in addition to one 
of the following messages: 

- BLOCK SEQUENCE ERROR, filename AT addr. 

- BLOCK TOO LARGE, filename AT addr. 

- WRONG PARITY, filename AT addr. 

The execution time limit for a job step 
expired resulting in job termination. 



The time limit requested exceeds that for 
which you are authorized. 

The specified function parameter address is 
out of range. 

The number of files in your catalog exceeds 
your limit. 



Ensure accuracy of 1HT 

format (F) parameter on 
command or macro. 



If a time limit was set 1AJ 

for the job, include a 

SETTL command requesting 

a longer time limit for 

the job step. If the 

job step time limit was 

the maximum for which 

you are validated, 

request a larger time 

limit or decrease the 

amount of processing to 

be performed by the job 

step. 

Request smaller time CPM 
limit. 

Specify a valid TLX 

parameter address. 

Purge one or more PFM 

permanent files to 
allow you to 
save or define 
additional files. 



TOO MUCH INDIRECT ACCESS FILE SPACE. 



TOTAL ASSIGNED COUNT ERROR. 



The cumulative size of the indirect access 
files in your catalog exceeds your limit. 



Dayfile message indicating R6SEX internal 

problem Csum of individual resource 
assigned counts differs from total assigned 
count in demand file entry). 



Purge or shorten 
one or more indirect 
access files to 
allow additional 
permanent file space. 

Inform site analyst. 



PFM 



TOTAL DEMAND COUNT ERROR. 



TRACK LIMIT. 



TRACK LIMIT, LVLX. 



Dayfile message indicating RESEX internal 
problem occurred (sum of individual 
resource demand counts differs from total 
demand count in demand file entry). 

No allocatable tracks remain on your 
permanent file equipment (error log and 
dayfile message). 



1MS is waiting for temporary file mass 
storage space on any mass storage device 
with access level LVLX. 



Inform site analyst. 



None; job will con- 
tinue as tracks 
become available. 
If problem persists, 
contact central 
software support. 

Inform site analyst. 



PFM 



1MS 



TRAILER BLOCK COUNT ERROR, filename AT 
address. 



The block count in the E0F1 or E0V1 label 
did not match the block count maintained by 
the tape executive during the read 
operation. 



Inform site analyst. 



1MT 
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MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



UNIDENTIFIED PROGRAM FORMAT. 



UNIT HUNG UP ON EOP OR BUSY, filename AT 
address. 

UNNECESSARY CIO FCT. nnn ON filename AT 
address. 



UNRECOGNIZED TERMINAL MODEL. 



The file you requested to be Loaded was in 
an unrecognizable format. 

Unit did not receive EOP on unit busy. 



The read or write CIO function specified by 
nnn was unnecessary, since your I/O buffer 
was already full (read) or empty (write) 
and no data could be transferred for this 
CIO call. The message is issued to the job 
dayfile only if analyst logging is enabLed 
on the system (console entry). 

You entered an invalid terminal model 
mnemonic as a parameter in the SCREEN 
or LINE command. 



Check the format of the 
file. 

Inform site analyst. 



Ignore or correct 
program to be more 
efficient. 



Retry with valid 
mnemonic. 



1AJ 



1MT 



IMS 



CONTROL 



USER ACCESS NOT VALID. 



USER ACCESS NOT VALID. 



USER ACCESS NOT VALID. 



USER ACCESS NOT VALID. 



USER ACCESS NOT VALID. 



USER SECURITY COUNT EXHAUSTED. 



VEJ - BUFFER ARGUMENT ERROR. 



VEJ - INCORRECT REQUEST. 



VSN FILE ERROR. 



pfn WAITING ALTERNATE STORAGE EXEC. 



WAITING FOR MAGNET. 



WAITING FOR NFL. 



WAITING FOR PN=packname, type. 



You tried to perform an operation for which 
you are not authorized. Possible causes 
include attempts to access a file or 
equipment which you are not authorized to 
access. 

You tried to perform an operation for which 
you are not authorized. Possible causes 
include attempts to 

- Run a system origin job from nonsystem 
origin. 

- Access a restricted subsystem without 
proper validation. 

- Enter an incorrect SRU value. 

- Use the V carriage control character 
without validation. 

You are not authorized to create direct 
access or indirect access files or to 
access auxiliary devices. 

The user name or password could not be 
v.=s!i dated, or ?■ seco"darv m$fr remand v?3s 
encountered while secondary USER commands 
were disabled. 



Ensure accuracy of 
command or determine 
proper validation 
requirements via LIMITS 
command. 

Ensure accuracy of 
command or macro, or 
determine proper 
validation requirements 
via LIMITS command. 



Contact site personnel 
concerning validations. 



Verify that user name 

ap.d ngssycrd 3rp ys! irf_ 

If secondary USER 
commands are disabled, 
ensure that no secondary 
USER commands are 
present. 

Retry with a lower value. 



Contact site personnel 
to reestablish access. 



The SRU or time limit request is outside of 
your validated range. 

The security count for the user name 
specified has been decremented to zero. 
You are denied all access to the operating 
system until the security administrator 
resets your security count. 

Dayfile message indicating that FET buffer Write a PSR and include 

pointers are incorrect. (FWA<LWA<FL) was support materials to 

not true or TID (terminal id) with complement allow CDC to duplicate 

address was not within the field length. the problem. 



Dayfile message indicating that one of the 
following conditions has occurred: 

- VEJ was not called by a subsystem. 

- The FET address was out of range. 

Dayfile message indicating that a RESEX 
internal problem occurred (VSN file entry 
does not match job identification). 

The file must be staged from alternate 
storage to disk and the alternate storage 
executive is not currently available to 
perform the stage operation. 



The job is waiting for the magnetic tape 
subsystem to be activated. 



Informative message stating that your job 
has been delayed and/or rolled out 
waiting for NFL space. The job has not 
been aborted; it will eventually continue. 
The message is visible via ENQUIRE. 

The job is waiting for the operator to 
mount pack packname on device type type. 



Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 

Inform site analyst. 



Wait for executive to be 
started or inform site 
operator that the 
alternate storage 
executive should be 
ilitialized. 

Wait for the operator to 
activate MAGNET or 
terminate job. 

None. 



Wait until the operator 
mounts the requested 
pack or terminate job. 



LFM 



DSD 

EXUBUT 

EXCSLV 

MSI 

8FSP 

RESEX 

1MA 

IAFEX 



CONTROL 



CPM 

IAFEX 

1AJ 



VEJ 



RESEX 



PFH 



RESEX 
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SIGNIFICANCE 



ACTION 



ROUTINE 



WAITING FOR RESOURCE FILE. 



The job is waiting for the resource demand 
file or VSN file to become available. 



Wait until resource file 
becomes available or 
terminate job. To 
operator: If job is not 
rolled out and this 
message persists, inform 
site analyst or drop the 
job. If the operator 
decides to override an 
interrupted job at this 
point, the preview data 
in the demand file is 
not cleared and the E,P 

rlie-nlau »-An* i m ia t? 4-n 

show the VSN request 
associated with the job 
until you Log off or 
issue a subsequent 



RESEX 



WAITING FOR RESOURCES. 



WAITING FOR VSN= vsn, type. 



The job is waiting for sufficient resources 
to alLow assignment of the tape/pack 
without causing a system deadlock. 

The job is waiting for the operator to 
mount the tape with VSN vsn on the 
specified type (MT, HD, PE, or GE). VSN= 
SCRATCH indicates that any scratch tape is 
acceptable. 



Wait until the resources 
become available or 
terminate job. 

Wait for the operator to 
mount the tape or 
terminate the job. 



RESEX 



RESEX 



WAITING ON TRACK LIMIT. 



The job is waiting for additional tracks on 
the familyname device containing the 
resource demand and VSN files. 



Wait for the additional 
tracks or terminate job. 



WRITE-DOWN OF DATA PROHIBITED. 



One of the following: 

On an APPEND or REPLACE command or 
macro, the access level of the local 
file is higher than the access level 
of the permanent file. 
On a DEFINE command or macro, the 
access level of a local file having 
the same name as the file specified 
has a lower access tevel than the 
job. 



Retry using a higher 
access level for the 
permanent file (APPEND 
or REPLACE), or change 
the job's access level 
and then retry (DEFINE). 



WRITE-DOWN PROHIBITED ON FILE, filename 
AT address. 



The access level of your job is higher 
than the access level of file filename, 
and the file is a tape file or a direct 
access file. 



None. You may not 
write on this file 
while your job is 
at the current 
access level. 



1MS 



WRITE ON READ-ONLY FILE filename AT address. 



Either you attempted to write on a file 
with write lock-out, or the direct access 
file was not attached in write mode. 



Reattach file in write 1NS 
mode or clear write IAFEX 

interlock. 



WRITE OVER LABEL ILLEGAL. 



WRITEDOWN PROHIBITED ON FILE FILENAME 
AT address. 



You attempted to write over the V0L1 label. 



The access Level of your job is higher than 
the access level of file filename, and the 
file is a tape file or a direct access 
permanent file. 



Have the operator blank 
Label the tape. 

None. You may not 
write on this f i le 
while your job is 
at the current 
access level. 



INT 
1MS 



WRONG PARITY, filename AT address. 



A seven-track tape is being read in 
opposite parity from which it was written. 



Ensure accuracy of 
format parameter (F) on 
command or macro. 



1MT 



XD/XT EXCEEDS MAXIMUM. 



The XD parameter for a password or file 
permission is more than the maximum number 
of days past the current date, or the XT 
parameter is larger than the maximum 
allowed. 



Correct XD or XT 
parameter and retry. 



XL BUFFER/FET PARAMETER ERROR, filename 
AT address. 



One of the following: 

- HDR1 label in extended label buffer or 
FET contains a nonnumeric display code 
value in a numeric field. 

- Character count in header word preceding 
labels in the extended label buffer does 
not equal 80. 



Correct condition that 
caused error and retry. 



500 BPI WRITE INCORRECT. 



The tape unit (667 or 677) cannot record 
data at 200 bpi. 



Specify a different tape 
density. 



1MT 
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GLOSSARY 



Abort 

To terminate a program, job, or job step 
when an error condition (hardware or 
software) exists from which the program 
or computer cannot recover. 

Absolute Assembly 

In the context of this manual, a COMPASS 
program assembled with the ABS pseudo 
instruction in which there are no 
references to external entry points. 
Compare with Relocatable Assembly. 

Access Category 

Refer to File Access Category, Job 
Access Category Set, and System Access 
Category Set. 

Access Level 

A property of each file, job, and 
equipment on a secured system that is 
used to indicate the sensitivity of 
information in the file or job, or the 
sensitivity of information that can be 
processed by the equipment. On a 
secured system, there are up to eight 
access levels corresponding to 
increasing levels of sensitivity, and 
each user is authorized to access some 
or all of those levels. Refer also to 
Equipment Access Levels, File Access 
Level, Job Access Level, and System 
Access Levels. 

Access Level Limits 

Refer to Job Access Level Limits. 

Account Block 

A string of commands between two CHARGE 
commands or between a CHARGE command and 
end-of-job. 

Allocatable Device 

A storage device allocated by the system 
without operator intervention that can 
be shared by more than one job. 



Consisting of alphabetic and/or numeric 
characters only. 

Alternate User Name 

A user name specified in a permanent 
file request which indicates the action 
is to be taken on an alternate user's 
permanent file. 



ANSI 



American National Standards Institute. 
An organization that establishes 
standards for the benefit of its member 
organizations. 

ASCII 

American National Standard Code for 
Information Interchange. The standard 
character set and code used for 
information interchange between systems. 

Auto Recall 

The act of a program releasing control 
of the CPU until a requested function is 
complete. Refer to Recall. 

Auxiliary Device 

Mass storage device that is not part of 
a permanent file family. Auxiliary 
devices can contain direct or indirect 
access permanent files. 

Block 



A grouping of user records created for 
efficiency in transfer between memory 
and storage devices. For magnetic 
tapes, it is the information between 
interrecord gaps. Block size is 
specified with the LABEL macro for L 
format tapes. 



BO I 



Refer to Beginning-of-Information. 
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Buffer 



Circular Buffer 



An intermediate storage area used to 
compensate for a difference in rates of 
data flow, or times of event occurrence, 
when transmitting data between central 
memory and an external device during 
input/output operations. 



A temporary central memory storage area 
that contains data during input/output 
operations. Routines that process I/O 
treat the first word of the buffer area 
as contiguous to the last word of the 
buffer area. 



Byte 



A group of 12 bits. Five bytes comprise 
a 60-bit central memory word. Bytes are 
numbered through 4 from the left. 



Central Memory (CM) 

The main storage device whose storage 
cells (words) can be addressed by a 
computer program and from which 
instructions and data can be loaded 
directly into registers from which the 
instructions can be executed or from 
which data can be manipulated. 

Central Processor Unit (CPU) 

The high-speed arithmetic unit that 
performs the addition, subtraction, 
multiplication, division, incrementing, 
logical operations, and branching 
instructions needed to execute programs. 



Command Record 

The first, and possibly only, record of 
a job file consisting of command images 
that start with the Job command and end 
with the first EOR, EOF, or EOI. Also 
refers to a procedure containing 
commands. 

Common Deck 

A subprogram or group of macro or symbol 
definitions that are accessed from a 
program library using the Modify CALL 
directive or COMPASS XTEXT 
pseudoinstruction. 



Compare/Move Unit (CMU) 

The hardware that executes the CPU 
instructions for moving and comparing 
data fields consisting of strings of 
6-bit characters. 



COMPASS 



Checkpoint 

The process of writing to a magnetic 
tape or mass storage file a copy of your 
job's central memory, the system 
information used for job control, and 
the names and contents of all assigned 
files that are identified in a CHECKPT 
request. 

Checkpoint File 

File on which the results of a partially 
completed job are dumped when a 
checkpoint request is processed. 

Checksum 

A numeric value used to verify a file. 



The standard assembly language used with 
CYBER 170, CYBER 70, and 6000 Computer 
Systems. Also, the command used to 
assemble a program written in the 
COMPASS assembly language. 

Control Byte 

A 12-bit code that changes the current 
input or output mode at an interactive 
terminal. 

Control Point 

The portion of central memory that is 
assigned to a job. When a job is 
allocated a portion of central memory, 
it becomes eligible for assignment to 
the central processor for execution. 



C-2 



60459690 B 



Refer to Central Processor Unit. 



CYBER Loader 



A 6-bit character code set used to 
represent alphanumeric and special 
characters. 



The utility that prepares programs for 
execution by placing program instruction 
and data blocks in central memory. 

CYBER Record Manager (CRM) 

A software product that allows a variety 
of record types, blocking types, and 
file organizations to be created and 
accessed. Products like COBOL 5, FORTRAN 
Extended 4, FORTRAN 5, Sort/Merge 4, 
Sort/Merge 5, ALGOL 5, and DMS 170 use 
CRM to manage execution time 
input/output. Neither the input/output 
of the operating system nor that of most 
of the system utilities such as COPY or 
SK.IPF is implemented through CYBER 
Record Manager. All CYBER Record 
Manager file processing requests 
ultimately pass through the operating 
system input/output routines. 

Dayf ile 

A chronological file created during job 
execution which forms a permanent 
accounting and job history record. 
Dayf ile messages are generated by 
operator action or when commands are 
processed. A copy of the dayf ile is 
printed with the output for each job. 
You must explicitly request it in an 
interactive job. 

Default 

A system-supplied option used when you 
do not supply the option. 

Device Type Code 

The 12-bit display code of the type of 
device upon which a file resides. 

Direct Access File 

A NOS permanent mass storage file that 
can be attached to the your job. All 
changes to this file are made on the 
file itself rather than a temporary copy 
of the file (compare with Indirect 
Access File). 



Disposition Code 

A two-character mnemonic indicating 
destination queue and format for 
processing a file named on a ROUTE 
function. 

ECS 

Extended Core Storage. Refer to 
Extended Memory. 

Empty PRU/Record 

A PRU that contains no user data. Refer 
also to Zero Length PRU. 

End-of-File (EOF) 

A boundary within a sequential file, but 
not necessarily the end of a file that 
can be referenced by name. The actual 
end of a named file is defined by EOI. 
For labeled tape, EOF and EOI (denoted 
by the EOF1 label) are the same. For 
multifile tape files, EOF and EOI do not 
correspond. In the product set manuals, 
an end-of-file is also referred to as an 
end— of —partition . 



End-of-Information (EOI) 

The end of data on a file. Information 
appearing after this point is not 
considered part of file data. In card 
decks, a card with a 6/7/8/9 multiple 
punch in column 1. On mass storage 
devices, the position of the last 
written data. On labeled tape, it is the 
E0F1 label. CYBER Record Manager defines 
end-of-information in terms of file 
residency and organization. 



End-of-Line (EOL) 

A separator in coded files that is 
represented by 12 bits of zero, 
right-justified in a 60-bit word. In 
some cases, up to 66 bits of trailing 
zero bits are considered an end-of-line. 
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End-of-Record (EOR) 



Equipment Status Table (EST) 



The terminator of a logical record. On 
a PRU device , a short PRU or a zero 
length PRU with a level designator of 
indicates EOR. On tapes that are not 
PRU devices , an interrecord gap 
indicates EOR. 

End -of -Tape (EOT) 

A reflective strip near the end of a 
magnetic tape. It is used to signal 
termination of operations on a 
particular tape volume. At least 5.5 
metres (18 feet) of tape must follow 
this marker. 

Entry Point 

A location within a program or procedure 
that can be referenced from other 
programs . Each entry point has a unique 
name with which it is associated. Refer 
to External Reference. 



EOF 



A list of all peripheral devices 
connected to the system. Each table 
entry indicates the status of a 
particular device. 

EST Ordinal 

The number designating the position of 
an entry within the equipment status 
table (EST) established at each 
installation. Devices are identified in 
operator commands by EST ordinals . 



Exchange Jump 

Execution of a CPU program is initiated 
by an exchange jump. The program is 
defined by the contents of the exchange 
package area before the exchange jump 
took place. For the program to execute, 
the proper contents of its operational 
registers must be loaded into the CPU. 
These register contents are what is 
contained in the exchange package area 
associated with the program. 



Refer to End-of-File . 



EOI 



Refer to End-of-Information. 



EOL 



Refer to End-of-Line. 



EOR 



Refer to End-of-Record. 



Exchange Package 

A 203-word table containing information 
used in exchange jumps during job 
execution: contents of central processor 
registers , RA and Ft, in central memory 
and in extended memory, and the program 
address. The table is stored in the 
job's field length and can be printed as 
part of the output of a central memory 
dump. 



EOT 

Refer to End-of-Tape. 

Equipment Access Levels 

A range of access levels specified for 
each equipment on a secured system. In 
order for a file to be stored or output 
on a given equipment, the file's access 
level must be within the equipment 
access levels for that equipment. 

Equipment Code 

Refer to Device Type Code . 



Exit Mode 

A group of flags that specify the types 
of errors that can cause the CPU to 
abort . 



Extended Core Storage (ECS) 

A type of extended memory that is an 
option available for 6000 Computer 
Systems, CYBER 70 Computer Systems, and 
CYBER 170 Computer Systems, except for 
models 176 and CYBER 180-class models. 
Refer to Extended Memory. 
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Extended Labeled Processing 



Fast Dynamic Loader (FDL) 



A tape processing mode in which all tape 
labels (including optional labels) ate 
read into a label buffer for further 
processing. 



Extended Memory 

An additional portion of memory 
available as an option. This memory can 
be used for program and data storage, 
but not for program execution. Special 
hardware instructions exist for 
transferring data between central memory 
and extended memory. Extended memory 
consists of either extended core storage 
(ECS) , large-core memory extended 
(LCME), extended semiconductor memory 
(ESM), or unified extended memory (UEM). 



Extended Semiconductor Memory (ESM) 

A type of extended memory that is an 
option available for 6000 Computer 
Systems, CYBER 70 Computer Systems, and 
CYBER 170 Computer Systems, except for 
models 176 and CYBER 180-class models. 
Refer to Extended Memory. 



External Reference 

A reference in a program to an entry 
point in another program. Throughout 
the loading process, externals are 
matched to entry point (this is also 
referred to as satisfying externals); 
that is, addresses referencing externals 
are supplied with the correct address . 



Family Device 

Mass storage permanent file device 
associated with a specific system, A 
family may consist of from 1 through 63 
logical devices . Normally , a system 
runs with one family of permanent file 
devices available. However, additional 
families may be introduced during normal 
operation. This enables users 
associated with the additional families 
to access their permanent files via the 
alternate family. 



A facility that provides fast loading 
and unloading of specially formatted 
code called capsules. The amount of 
memory required for job execution can be 
greatly reduced because capsules can be 
easily loaded and unloaded as needed, 
freeing memory for other uses . 



FET 



Refer to File Environment Table. 

Field Length 

The area in central memory allocated to 
a particular job; the only part of 
central memory that a job can directly 
access . Also the number of central 
memory words required to process a job. 

Field Length Extended (FLE) 

Amount of extended memory assigned to an 
executing job. 

File 

1. A set of information that begins at 
beginning-of-inf ormation (BOI) , ends 
at end-of-inf ormation (EOI) , and is 
referenced by a local file name . 

2. That portion of a multifile file 
terminated by an end-of-file (EOF). 

3. Data recorded on a magnetic tape 
beginning after an HDR1 label and 
ending before an E0F1 label. 

NOS commands requiring a parameter that 
is a file name refer to definition 1 . 
Commands requiring a parameter that 
specifies the number of files refer to 
definition 2. Definition 3 applies only 
to labeled magnetic tapes. 

File Access Category 

A property of a permanent file used by 
the creator of the file on a secured 
system to restrict access of the file to 
a particular group of users. A secured 
system supports up to 32 access 
categories, and each user is authorized 
to use some, all, or none of those 
categories. Refer also to Job Access 
Category Set and System Access Category 
Set. 
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File Access Level 



File Set 



A property of each file on a secured 
system used to indicate the sensitivity 
of information contained on the file. A 
file is assigned the current job access 
level by default when it is created or 
stored; the file creator may specify any 
access level for that file that is 
within the set of access levels valid 
for the job, the system, the file 
creator, and (for interactive jobs) the 
communication line to the host 
mainframe. Any user who accesses a file 
on a secured system must be validated 
for the access level of the file. Refer 
also to Access Level, Job Access Level, 
and Job Access Level Limits. 

File Environment Table (FET) 

A table within a progam's field length 
that defines the current status and 
properties of a file being used by the 
program. The program communicates with 
operating system input/output routines 
through the FET. One FET exists for each 
file in use by the program. 

File Flushing 

The process of writing the contents of a 
file's circular buffer to mass storage 
when certain conditions are met. 



File Name Table (FNT) 

A system-managed table that contains job 
control information for all active files 
in the system. Files that are local to 
a job have an entry in the job's local 
file name table (refer to Local File 
Name Table); system files have an entry 
in the system file name table (refer to 
System File Name Table). Each file name 
table entry consists of a file name 
table word, a file status table word, 
and, for local files, a file utility 
table word. 



File Name Table (FNT) Word 

The first word of every file name table 
entry. This word contains the local 
file name, file type, and other job 
control information. 



One or more tape files referred to by 
the set identifier on a tape assignment 
command or macro. A file set may 
consist of: 

1. One file recorded on a single volume. 

2. More than one file recorded on a 
single volume. 

3. One file recorded on more than one 
volume . 

4. More than one file recorded on more 
than one volume. 

All files within a file set have the 
same set identifier in their HDR1 labels. 

File Status Table (FST) Word 

The second word of every file name table 
entry. This word contains information 
pertaining to the file's location on 
mass storage and other job control 
information. 

File Utility Table (FUT) Word 

The third word of every file name table 
entry. This word contains the 12-bit 
installation area for the file; the 
remainder of the word is reserved for 
future use. 



FL 



Refer to Field Length. 



Flag 



A character or bit that signals the 
occurrence or presence of a particular 
condition. 



FLE 

Refer to Field Length Extended. 
FNT 

Refer to Local File Name Table. 
FNT Word 

Refer to File Name Table Word. 
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Foreign Tape 

NOS classifies all non-CDC standard 
tapes into either of two tape groups, 
foreign or stranger. Trie foreign tapes 
are defined by the F data format, which 
has an unknown maximum block size. 
Contrast with Stranger Tape. 



Frame 



A tape recording unit made up of 1 bit 
from each tape track (7 bits for 7-track 
tape and 9 bits for 9-track tape). Each 
frame on a coded tape usually represents 
one character. 

FST Word 

Refer to File Status Table Word. 

Full Track (FT) 

Reading/writing sequential sectors on a 
rotating mass storage device. 

Function Processor 

A system CPU or PP program that the user 
can call by placing a request in 
location RA+1. Function processors 
perform input/output, local and 
permanent file manipulations, and so on. 

Generation 

The position of a file within a series 
of files, each file developed from the 
preceding file. The generation number 
and generation version number of a tape 
file can be entered in its HDR1 label. 

Global Library Set 

An ordered set of libraries used for 
program loads and for satisfying 
externals; these libraries remain in 
effect throughout job execution unless 
specifically changed. 

Half Track (HT) 

Reading/writing alternate sectors on an 
844 or 885 disk pack. 

Indirect Access File 

A NOS permanent file that is accessed by 
making a temporary copy of the file (GET 
macro) . It is created or altered by 
saving or replacing the contents of an 



existing working file (REPLACE or SAVE 
macro). 

Input File Type 

Job file. Its first record is a control 
statement record, which may be followed 
by records containing data, directives, 
or programs used by job steps. 

Interactive Programs 

CPU programs in which the user and the 
computer communicate with each other. 

Interrecord Gap 

Space skipped between the writing of 
data blocks on magnetic tape. 

Interrupt 

To stop a running program in such a way 
that it can be resumed at a later time. 
Also a special control signal which, 
when issued, causes action as described 
by the program. 

Job Access Category Set 

On a secured system, a set of access 
categories is set when the job is 
initiated. This set is the intersection 
of the user's set of validated access 
categories and the system access 
category set. Refer also to File Access 
Category and System Access Category Set. 

Job Access Level 

On a secured system, each job has an 
access level. This is the default 
access level that is assigned to files 
that are created or stored in the job. 
A job's initial access level is the 
lower access level limit for the job. 
The job's access level is automatically 
raised to the access level of any file 
from which information is read. The job 
access level can also be changed by the 
user. Refer also to Job Access Level 
Limits . 

Job Access Level Limits 

An upper limit and a lower limit that 
determine the range of access levels 
that are valid for a particular job on a 
secured system. All files used in a 
given job must have an access level 
within the job's access level limits. 
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Job Step 



Library File 



An individual command, procedure or 
loader sequence. A group of job steps 
forms a job stream, command record, or 
procedure file. 

Label 

A block at the beginning or end of a 
magnetic tape volume or file, which 
serves to identify and/or delimit that 
volume or file. 

Large Central Memory Extended (LCME) 

A type of extended memory that is an 
option available for model 176. Refer to 
Extended Memory. 

LCME 

Refer to Large Central Memory Extended. 
Level Designator 

Refer to Level Number. 



Either a read-only file that can be 
accessed by several users simultaneously 
or a file you specify on a LIBRARY 
command . 



Line 

Refer to Zero-Byte Terminator and 
End-of -Line . 

List of Files 

A table containing names of files that 
are to be considered for file flushing. 



Load Point 

Metallic strip marking the beginning of 
the recordable portion of a magnetic 
tape. Data, including labels, is 
written after the load point. A rewind 
positions a single file volume to the 
load point. 



Level Number 

The level number is an octal number in 
the terminating marker of a PRU, ranging 
from 00 to 17 (octal). A level 17 in an 
empty PRU designates an EOF. A level 
in a short PRU designates an EOR. A 
level designator of 1 is used as a flag 
to indicate that a short PRU of data is 
actually a line of input data from a 
terminal. The level designator is 
returned to the FET for some read 
functions and to the trailing control 
word for a READCW function. 



lfn 



Refer to Local File Name. 



Library 



A file or collection of files containing 
executable programs and tables needed to 
locate and load the programs. A system 
library can contain peripheral processor 
programs in addition to the central 
processor programs. A user library is 
file formatted as a library but is not 
available to a job until it has been 
explicitly declared via CYBER Loader 
commands or macros. 



Local File 

Any file that is currently associated 
with a job. Local files include all 
temporary files and attached direct 
access files. 

Local File Name 

The file name assigned to a file while 
it is local (assigned) to a job. The 
name is contained in the local file name 
table. 

Local File Name Table (FNT) 

A system-managed table that contains the 
local file name, the file type, and 
other job control information. 

Locked File 

A file on which you cannot write. 



Logical Identifier (LID) 

A three-character alphanumeric string 
used to identify a particular mainframe 
in a loosely coupled network. LIDs are 
identified by your site. 
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Logical Record 

A data grouping that consists of zero or 
more PRUs and ends with a short PRU or a 
zero-length PRU. 

Macro 

A sequence of source statements that are 
saved and then assembled whenever needed 
through a macro call. 



MLRS 



Maximum logical record size. A number 
that specifies the maximum size for a 
logical record for S and L tape formats. 



Old Program Library (OPL) 

A Modify-f ormatted program library that 



and common decks. 



opdef 



A sequence of source statements that are 
saved and then assembled whenever needed 
through an opdef call. Differs from a 
macro in that the assembler interprets 
the call by examining the format or 
syntax of the instruction rather than 
the contents of the operation field 
alone. 



OPL 



Multifile File 

A file containing more than one logical 
file. It begins at BOI and ends at 
EOI. On a labeled tape, a multifile 
file is delimited by corresponding HDR1 
and E0F1 labels. 

Multifile Set 

A tape file set having more than one 
tape file. 

Network 

A data and message switching and routing 
system used to provide communication 
between terminals, applications, and 
mainframes. 

Network Terminal 

A terminal that communicates with the 
operating system through the network. 

Nonallocatable Device 

A device (such as a magnetic tape unit, 
card reader, card punch, or line 
printer) which can be used only by one 
job at a time. 

Nonstandard Tape Label 

A tape label format for a tape whose 
data cannot be processed by the system 
because the label is not one of the 
supported label types. If the tape is at 
load point, a subsequent read operation 
skips to the first tape mark. 



Refer to Old Program Library. 



Overlay 



One or more relocatable program modules 
that have been relocated and linked into 
a single absolute program. It can be a 
main, primary, or secondary overlay. 



Pack Name 



A one- through seven-character name that 
identifies the auxiliary device to be 
accessed in a permanent file request. 



Parameter 



A variable that is given a specific 
value for a particular purpose or 
process. 



Parity 



In writing data, an extra bit is either 
set or cleared in each byte so that 
every byte has either an odd number of 
set bits (odd parity) or an even number 
of set bits (even parity). Parity is 
checked on a read for error detection 
and possible recovery. 



Password 



1. A system access word that must be 
used in addition to the user name at 
login. 

2. A file access word that controls 
access to a particular file by 
alternate users. 
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Permanent File 



Print File 



A mass storage file that is cataloged by 
the system so that its location and 
identification are always known to the 
system. Permanent files cannot be 
destroyed accidentally during normal 
system operation. They are protected by 
the system from unauthorized access 
according to privacy controls specified 
when they are created. 

Permanent File Catalog (PFC) 

A 16-word entry that the system 
maintains and uses to determine 
attributes of a permanent file. 

Permanent File Family 

Permanent files which reside on the 
family devices of a specific system. 

Physical Record 

On magnetic tape, information between 
interrecord gaps (refer to Block). It 
need not contain a fixed amount of 
data. For mass storage, refer to 
Physical Record Unit. 

Physical Record Unit (PRU) 

The amount of information transmitted by 
a single physical operation of a 
specified device. For mass storage 
files, a PRU is 64 central memory words 
(640 characters); for magnetic tape 
files, the size of the PRU depends upon 
the tape format. A PRU that is not full 
of user data is called a short PRU; a 
PRU that has a level terminator but no 
user data is called a zero-length PRU. 



PP 



Refer to Peripheral Processor. 

Primary File 

A temporary file created with either the 
OLD, NEW, LIB, or PRIMARY command or the 
PRIMARY macro for most systems. The 
primary file is assumed to be the file 
on which most operations are performed 
unless another file is specified. There 
can be only one primary file associated 
with a job. The primary file is rewound 
before each job step given. 



An output file containing data to be 
printed at a central site or remote 
batch line printer. 

Private Auxiliary Device 

Auxiliary device associated with a 
specific user name. Only that user name 
may create files on the device, although 
other users may be permitted to access 
files which reside on the device. 

Program Library 

The file generated by Modify that 
contains the decks of line images. Line 
images in the program library are in a 
format that can be manipulated by Modify. 

PRU 

Refer to Physical Record Unit. 

PRU Device 

A magnetic tape file or a mass storage 
device. Records on these devices are 
written in physical record units (PRUs). 



Pseudoinstruction 

An assembler-defined instruction 
appearing in the operation field of a 
statement. It normally does not specify 
the assembly of a single machine 
instruction, but instead specifies some 
other assembly process (such as symbol 
definition or listing control) . 



Public Auxiliary Device 

Auxiliary device available for access by 
all validated users knowing the correct 
pack name. Additional validation is 
required to create or replace files on 
an auxiliary device. 

Punch File 

Output file containing data to be 
punched on cards. 



QFT 



Refer to Queued File Table. 
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Qualified Symbol 



Reference Address (RA and RAE) 



A symbol defined when a qualifier is in 
effect during assembly. Through 
qualification, the same symbol can be 
referred to in different subprograms 
without conflict. 

Queued File Table (QFT) 

A central memory resident table 
containing a fourword entry for all 
active input and output queue files. 

Random Access 

Access method by which any record in a 
file can be accessed at any time. 
Applies only to mass storage files with 
an organization other than sequential. 
Compare with Sequential Access. 

Random File 

A file with an index entry to each 
record in the file. A file on a 
rotating mass storage device is a 
randomfile only when the random bit is 
set in the file environment table. The 
last record of the file is an index. 



RA is the absolute central memory 
auuicss tuat is t.iL& starting or zero 
relative address assigned to a program. 
Addresses within the program are 
relative to RA. RA+1 is used as the 
communication word between the user 
program and the system. RAE is the 
absolute extended memory starting 
address assigned to a program. 



Register 



A register is a storage device used to 
hold binary data. There are 24 hardware 
registers (eight A registers s eight B 
registers, and eight X registers) in the 
CPU that can be directly controlled by a 
COMPASS program. The A registers contain 
addresses of words in central memory, 
the B registers are used for 
incrementing and indexing, and the X 
registers contain operands used in 
calculations and the results of these 
calculations. Other hardware registers 
contain information that is used by the 
operating system or by system hardware. 



Recall 



Relative Address 



The state of a program when it has 
released control of the central 
processor until a fixed time has elapsed 
(periodic recall) or until a requested 
function is completed (auto recall). 
Recall is a system action request as 
well as an optional parameter of some 
file action requests. 



All addresses in a relocatable program 
are relative to a base address of zero. 
When a relocatable program is loaded for 
execution, the zero base address is 
assigned to a reference address. At 
that time, all addresses in the program 
become relative to the reference address. 



Record 



Relocatable Assembly 



Refer to Logical Record. 



Record Separator 

In NOS, another name for an 
end-of-record (EOR). 



Reel 



Refer to Volume. 



An assembled program that contains 
references to external entry points . 
Compare with Absolute Assembly. 



Removable Device 

A rotating mass storage device that the 
system can make unavailable. It is not 
necessary that the device be physically 
detachable from the rotating mass 
storage drive. 
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Rollout 



Security Unlock Status 



The removal of jobs from central memory 
to mass storage before execution is 
complete , so the control point and 
central memory can be assigned to 
another job. A job is rolled out when 
it is waiting for an external event, 
when its control point and/or central 
memory is needed by a higher priority 
job, or when it exceeds its central 
memory time slice. 

Rollout File 

A file containing a job (and system 
information) that has been temporarily 
removed from the main processing area of 
the system. 

Rotating Mass Storage (RMS) 

A disk storage device . 
Sector 

Refer to Physical Record Unit. 

Secured System 

A system in which a mandatory security 
mechanism has been enabled during 
deadstart. A secured system protects 
information by enforcing restrictions 
based on access levels and access 
categories, and restricts many sensitive 
system functions to security 
administrators . 



This status of the system console 
applies only to a secured system and 
must be set by a security adminstrator . 
The console must be in security unlock 
status in order for the security 
administrator to perform certain 
functions that are restricted on a 
secured system. 



Sense Switches 

Six 1-bit flags located in the user's 
control point area and in bits 11 
through 6 of RA+0 of the job field 
length. These bits can be used to 
communicate with system routines (refer 
to the ONSW and OFFSW macros in section 
6). 



Sequential Access 

A method in which only the record 
located at the current file position can 
be accessed. Refer to Random Access. 



Sequential (SQ) File 

A file in which records are accessed in 
the order in which they occur. Any file 
can be accessed sequentially. 



Short PRU 



Security Administrator 

A secured system prevents users and 
operators from performing certain 
functions that could result in the 
unauthorized disclosure of information. 
These functions can only be performed by 
a person who is designated a security 
administrator. A security administrator 
is always authorized to access the 
highest level of information stored on 
the system. This person performs 
functions in the areas of installation, 
user validation, system operation, and 
system maintenance. 

Security Count 

The number of security violations you 
have left before you are denied access 
to the system. 



A PRU that does not contain the maximum 
amount of character data allowed for a 
PRU. Refer to Zero-Length PRU. 



Special Entry Point 

An entry point that enables system 
programs to perform special functions. 

SRU 

Refer to System Resource Unit. 

Standard Labeled Tape 

A tape with labels conforming to 
American National Standard Magnetic Tape 
Labels for Information Interchange 
X3. 27-1969. Also called a system 
labeled tape. 
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Sfranjor T. 



ger iape 



System Reauest 



NOS classifies all non-CDC standard 
tapes into either of two tape groups, 
foreign or stranger. The stranger tapes 
are defined by the S data format, which 
has a maximum block size of lOOOg CM 
words. Contrast with Foreign Tape. 

Symbol 

A set of characters that identifies a 
value and its associated attributes. 

System Access Category Set 

On a secured system, a set of access 
categories are set during level 
deadstart. This set may consist of 
some, all, or none of the 32 possible 
access categories. While the system is 
running, users may only use access 
categories that are within the set of 
system access categories. Refer also to 
File Access Category and Job Access 
Category Set . 

System Access Levels 

On a secured system, a range of access 
levels is set during level deadstart. 
This range may contain some or all of 
the eight possible access levels. While 
the system is running, users may only 
use access levels that are within the 
range of system access levels . 

System File 

A file that can be accessed only by a 
system program. 

System File Name Table 

A system-managed table that contains a 
file name table entry for the various 
system files. 

System Labeled Tape 

Refer to Standard Labeled Tape, 

System Library (SYSLIB) 

The collection of tables and object 
language programs that reside in central 
memory or on mass storage and are 
necessary for running the operating 
system and its product set. 



A request placed in location RA+1 for a 
function processor to perform a special 
process. 

System Resource Unit (SRU) 

A unit of measurement of system usage. 
The number of SRUs includes the central 
processor time, memory usage, and 
input/output resources used for a given 
job. 

System Text 

A set of tables containing symbol , 
micro, macro, and opdef definitions that 
can be saved on a file to be accessed by 
other programs . 



Tape Format 

A parameter that specifies the internal 
recording format of a magnetic tape. 

Tape Mark 

A delimiter written on tapes under 
operating system control to separate 
label groups, files, and/or labels. 
Interpretation depends on the tape 
format . 

Temporary File 

A file that is currently associated with 
a job and is not a permanent file. 
Temporary files cease to exist when they 
are returned to the system (either by 
means of a command or macro or upon job 
termination). 

Time Slice 

The amount of CPU or CM time a job is 
allowed to use before the system lowers 
its priority to allow other jobs to 
execute . 

Timed /Event Rollout 

A condition in which an executing job 
has been temporarily removed from 
central memory but will be rolled back 
into central memory when a specified 
event (such as a file is no longer busy) 
or a specified time period has elapsed. 
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UEM 



VSN 



Refer to Unified Extended Memory. 



Refer to Volume Serial Number. 



Unified Extended Memory 



Word 



A type of extended memory that is 
available as an option for CYBER 
180-class models and models 865 and 
875. UEM differs from other types of 
extended memory in that it is a portion 
of central memory and not a separate 
memory unit. Refer to Extended Memory. 

Unlabeled Tape 

A magnetic tape that does not have a 
header label. Unlabeled tapes generated 
by the operating system contain a 
trailer label similar to the trailer for 
a standard labeled tape. 

Unsecured System 

A system in which the security mechanism 
has not been enabled during deadstart . 
The restrictions based on access levels 
and access categories are not enforced 
on an unsecured system. 

User Index 

A unique 17-bit identifier that is 
associated with each user name . The 
user index is used by the permanent file 
manager to identify the device and 
catalog track for the user's permanent 
files. 



A group of bits that occupy a single 
memory cell. A central memory or 
extended memory word is 60 bits in 
length. The bits are numbered 59 
through starting from the left. A 
word is also composed of five 12-bit 
bytes, numbered through 4 from the 
left. 

Write Ring 

A circular device inserted into a tape 
reel indicating to the tape unit that it 
can write on that reel. NOS checks for 
the presence of a write ring if you 
request it. 

Zero-Byte Terminator 

The 12 bits of zero in the low order 
position of a central memory word that 
are used to terminate a line of coded 
information. A record with such a 
terminator in CYBER Record Manager is a 
zero-byte record (Z type record). 

Files created interactively at a 
terminal, and by commands that manipulate 
coded lines contain zero-byte terminated 
records. The image of cards input 
through a card reader also has such a 
terminator. 



Validation File 

File containing validation information 
for all users (user names, passwords, 
resources allowed, and so on). 

Volume 

A reel of magnetic tape. A given file 
can be composed of more than one volume . 

Volume Serial Number (VSN) 

A one- through six-character identifier 
that identifies the volume of magnetic 
tape to the system. 



In 6-bit display code, two colons create 
12 bits of zeros in the 64-character 
set. If two consecutive colons occur in 
a file that contains zero-byte 
terminated records, they might be stored 
in the lower order portion of a word and 
create a zero-byte terminator. 

ClO-coded I/O operations, system 
commands, and dayfile processing macros 
use files whose lines are terminated by 
a zero byte. 

Zero-Length PRU 

A PRU that contains system information, 
but no user data. Under NOS, a 
zero-length PRU defines EOF. 
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INTERPRETIVE MODE READING AND WRITING 
OF EXTENDED MEMORY 



Interpretive mode processing of extended memory read and write operations gives the COMPASS 
programmer an effective means of breaking up large block extended memory transfers and 
processing recoverable extended memory errors . The efficiency of long extended memory 
transfers tends to be degraded because of PP-initiated exchange jumps which force extended 
memory transfers to be completely restarted. Interpretive mode processing breaks up large 
blocks into smaller, 4008-word blocks, thereby minimizing the effects of these exchanges. 
Extended memory transfer errors are retried as a block transfer and then as single word 
transfers if necessary. If the error is recovered, it is logged in the system error log and 
is transparent to the user program. Unrecoverable errors are also logged and must be 
processed by the user program. 

The interpretive routines are available on common deck COMCECS for absolute COMPASS programs 
and as relocatable routines in SYSLIB for relocatable COMPASS programs. Additionally, 
common deck COMCECM is provided to redefine the RE and WE COMPASS instructions. COMCECM is 
also available on systems text ECSTEXT. Thus, for absolute COMPASS programs, the user must 
either make specific calls to both common decks or call COMCECS and specify S=ECSTEXT on the 
COMPASS command (refer to the COMPASS Reference Manual). For relocatable COMPASS programs, 
you need only specify ECSTEXT as an alternate systems text on the COMPASS command. 

Programs using interpretive mode reading and writing of extended memory do so with the usual 
RE and WE COMPASS instructions. If, while in interpretive mode, you desire to perform 
noninterpretive reading and writing of extended memory, the RD and WT instructions must be 
used. These instructions are defined on common deck COMCECM. These instructions read and 
write extended memory directly while in interpretive mode , as in the normal execution of the 
RE and WE instructions. 

The instructions defined in ECSTEXT and common deck COMCECM are in the following formats. 1 

inst Bj 

inst K 

inst Bj+K 

Instruction inst is one of the following. 

inst Description 

RE Read extended memory in interpretive mode 

WE Write extended memory in interpretive mode 

RD Read extended memory noninterpretively in interpretive mode 

WT Write extended memory noninterpretively in interpretive mode 
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This appendix provides special information available to the applications programmer. The 
following topics are described. 



s Job communication area 

• Exchange package area 

• File types and job origin codes 

• Device types 



EJT status and connection status codes 
Service class codes 
EJT job scheduling data formats 
Error flags 



JOB COMMUNICATION AREA 

Figure E-l illustrates the first 100 8 words of the job's field length. 




+27 

+47 

+64 
+ 65 
+66 
+67 
+70 



+77 



parameters from the program call statement 
(available to the user during job execution) 



special program parameter area 



clwe 



clfw 



jot 

-v? 




z* 



np 



two 



command Image 

(may be replaced by operator message) 



ARGR 



SPPR 



PGNR, ACTR 
CMUR, LWPR 
XJPR, JOPR, FWPR 
CSMR, LDRR 
CCDR 



Figure E-l. Job Communication Area 
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Word 


System 
Identlfiert 


Bit(s) 


Field 


RA+0 




59-16 


reserved 






15 


i 






14 


cf 






13 


s 






12 


P 






11-06 


ssw 






05-00 


reserved 


RA+1 




59-41 


sname 






40 


r 






39-36 


unused 






35-00 


argument! 


RA+2 
through 

RA+63 8 


ARGR 


59-00 


params 


RA+64 8 


PGNR 


59-18 


nam 




ACTR 


17-00 


np 


RA+65 8 


CMUR 


59 


cm 




LWPR 


58-36 


clwe 






35-19 


unused 






18 


lb 



Significance 

Reserved. 

Subsystem idledown flag. 

CFO bit. 

Status bit for pause flag. 

Pause flag. 

Sense switches . 

Reserved. 

System request name (such as CIO). 

Auto recall flag. 

Reserved for future system use. 

Parameters passed to that portion of the 
system that processes the sname request . 

Parameters from the program call command; 
available to the user during execution. 

Name of program called by command. 
Number of parameters in command call. 

Set if the compare/move unit (CMU) is present. 
LWA+1 of loadable area in extended memory. 
Reserved for future system use. 
Library flag: 

Load from local file or user library. 

1 Load from system library or global 
library set. (You can distinguish a 
global library load from a system 
library load by checking bit 48 of the 
word returned by the GETLC macro.) 



tThese symbols are available to a user program if the program calls the SYSC0M macro. The 
SYSCOM macro is available in both SYSTEXT and N0STEXT. 
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System 
Word Identifier t Bit(s) Field 



Significance 



RA-^6g XJPR 



JOPR 



FWPR 



RA467o CSMR 



'8 



LDRR 



RA+70 8 CCDR 

through 

BA+77g 



59 



58-36 


clfw 


35-24 


jot 


23-20 


unused 


19 


d 


18 


r 


17-00 


fwo 


59 


cs 


58-30 


unused 


29 


c 



28-00 
59-00 



unused 

command 
image 



If Common Memory Manager is loaded in the 
job's field length, bits 17 through contain 
the complement of the address of the next 
word available for loading (refer to the 
Common Memory Manager Reference Manual). 

Always set to 1 to indicate that the hardware 
feature CEJ/MEJ is available. 

FWA of loadable area in extended memory. 

Job origin type. 

Reserved for future system use - 

DIS flag. 

RSS flag. 

First word of object program. 

Set if system is running in 64-character set 
mode. 

Reserved for future system use . 

Completion flag : 

Load not completed. 

1 Load completed. 

Reserved for future system use. 

Image of command currently being 
executed. 



t These symbols are available to a user program if the program calls the SYSCGM macro. The 
SYSCOM macro is available in both SYSTEXT and NOSTEXT. 
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EXCHANGE PACKAGE AREA 

Figure E-2 illustrates the exchange package area for CYBER 180-class models and models 865 
and 875. This illustration and the description that follows it are intended for use by the 
applications programmer and, therefore, do not include descriptions of bits or fields not 
used by applications programs. 





59 56 53 47 


35 


17 




000 
001 
002 
003 
004 
005 
006 
007 
010 
011 
012 
013 
014 
015 
016 
017 




P 


A0 


BO 




f 
I 


RA 


A1 


B1 


FL 


A2 


B2 


EM 


Flags 


EM 


M%m 


A3 


B3 


1 


RAE 


A4 


B4 


FLE 


A5 


B5 


Hi 


MA 


A6 


B6 


Y //////////////////// //t 


A7 


B7 


xo 


XI 


X2 


X3 


X4 


X5 


X6 


X7 







Figure E-2. Exchange Package Area 

The exchange package area fields are defined as follows (fields are applicable to all N0S 
computer systems unless otherwise noted) . 

Field Description 

P Program address (0<P<FL-1). 

M Address registers. 

Bi Increment registers. 

RA Reference address for central memory. 

FL Field length for central memory. 



E-4 



60459690 D 



Field 



Description 



EM 



Exit modes. An exit mode is selected or disabled by setting or clearing 



Bit(s) 

50 
49 

48 



Meaning When Bit is Set 



* y*ZL 



All models except model 176: exit on operand out of range 
(infinite operand) . 

All models except model 176: exit on address out of range, 
Model 176: exit on underflow.f 



Flags 



Bit 

56 
55 
54 
53 
52 

51 



Description 

UEM enabled. 

Expanded addressing select (ESM mode flag) . 

Extended block copy flag. 

Be served. 

Stack purging on models 815, 825, 835, 845, and 855 

(reserved on other models). 

He served . 



COND 



Error condition flags (model 176 only). 

Bit(s) Description 

47, 46 Reserved for Control Data. 

45 Extended memory block range condition. 

44 CM block range condition. 

43 Extended memory direct range condition. 

42 CM direct range condition. 

41 Program range condition. 

40 Not used. 

39 Step condition. 

38 Indefinite condition. 

37 Overflow condition. 

36 Underflow condition. 



RAE 

FLE 

Xi 



Reference address for extended memory. 

Field length for extended memory. Bit 56 is zero for all applications 
programs. 

Operand registers . 



tAn address out-of- range condition always causes a program exit on a model 176. 
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EJT CONNECTION STATUS CODES 

The following EJT connection status codes are valid, 
system OPL common deck COMSEJT.) 



Code Value (Octal) 



NICS 



DTGS 



(These mnemonics are defined in the 



Description 



Not interactive. There is no relationship between a job 
with this connection status and IAF. All batch, remote 
batch, and system origin jobs are assigned this connection 
status. A job in this state is not recoverable. 

Detached. A logical connection existed between a job with 
this type of connection status and an interactive device. 
However, the logical connection no longer exists (due to a 
detach command, line disconnect, IAF abort, or other 
condition). A job in this state continues to execute until 
an interactive request is issued. A job in this state is 
recoverable . 



OLCS 



3-13 
14-17 



On-line. A logical connection exists between a job with 
this type of connection status and an interactive device. 

Reserved for Control Data. 

Reserved for installations. 



EJT JOB STATUS CODES 

The following EJT job status codes are valid. 
OPL common deck COMSEJT.) 



Code Value (Octal) 



PRJS 



EXJS 
ROJS 



SIJS 



SOJS 



(These mnemonics are defined in the system 



Description 



Preinitial job step. A job is in this state after it has 
been assigned to a control point for the first time. A job 
in this state is available to be scheduled to a control 
point. 

Executing. The job is currently at a control point. 

Scheduler rollout. The job was rolled out by the job 
scheduler because the job's scheduling priority is lower 
than the priority of another job in the rollout queue. A 
job in this status is waiting to be rolled in to a control 
point. 

SCP rollin. An SCP swapin request was issued to roll in the 
job. The job is currently waiting to be rolled in to a 
control point. 

SCP rollout. The job was rolled out due to an SCP swapout 
request. The job remains rolled out until its job status is 
changed to SIJS. 
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Code Value (Octal) 



Description 



TOJS 



IOJS 



DOJS 



SUJS 



ERJS 



NVJS 



10 

11 

12 
13-30 
31-37 



Timed/event rollout. The job was rolled out because a 
timed/ event was posted. The job remains rolled out until 
its job status is changed to ROJS. 

Interactive rollout. The job rolled out due to interactive 
I/O processing. The job remains rolled out until its job 
status is changed to ROJS. 

Disabled rollout. The job was rolled out because it was a 
TXOT job with no further commands to process. The job 
remains rolled out until the job status is changed to ROJS. 

Suspended rollout. The job was rolled out because it was 
suspended. The job remains rolled out until the job status 
Is changed to ROJS. 

I/O error on rollout. The system encountered a mass storage 
read error while attempting to roll in a job- The job is 
left in this job state until a level deadstart. 

Reserved. 

Reserved for Control Data. 

Reserved for installations. 



EJT Scheduling Data Field 

The EJT scheduling data field is returned for executing jobs in a QAC PEEK request. The 
information in this field depends on the current stage of execution of the job. 



PRJS (Preinitial Job Step) 
29 23 



entry time 



EXJS (Executing) 
29 17 



11 



ROJS (Scheduler Rollout) 
29 23 



entry time 



q 1 control 
| point 


priority 



SOJS (SCP Rollout) 

Scheduling data field not used. 

TOJS (Time/Event Rollout) 

29 23 11 



time 


EST ordinal 

of event 
information 


event 



IOJS (Interactive Rollout) 
29 23 1 



word 
count 


track 


sector 



SIJS (SCP Rollin) 



29 


11 


completion bit 
relative addr 


SCP SSID 
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DOJS (Disabled) 

Scheduling data field not used. 



SUJS (Suspended) 
29 23 



scheduler timeout 



FILE TYPES AND ORIGIN CODES 

The following file types and origin codes are used in many NOS system routines. 
The following file types are valid. (These mnemonics are defined in NOSTEXT.) 
Type Value (Octal) Description 



-- 


0-6 


Reserved. 


ROFT 


7 


Rollout. 


Lti.r x 


i'O 


Library » 


PTFT 


11 


Primary terminal. 


PMFT 


12 


Direct access permanent file. 


FAFT 


13 


Fast attach file. 


SYFT 


14 


System. 


LOFT 


15 


Local. 


— 


16 


Reserved. 


INFT 


17 


Input . 


QFFT 


20 


Deferred routed queue file. 


— 


21-77 


Reserved. 



The following job origin types are valid. (These mnemonics are defined in NOSTEXT.) 
Type Value (Octal) Description 

System. 

1 Local batch. 



SYOT 
BCOT 
RBOT 



IAOT 



Remote batch (the symbol EIOT is also available but will be 
deleted in a future NOS release) . 

Interactive (the symbol TXOT is also available but will be 
deleted in a future NOS release) . 
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The following service class types are valid. The service class code is the first two 
letters of each service class type. These mnemonics are defined in the system OPL common 
deck COMSSCO. 



Type 



SYSC 



Value (Octal) 



BCSC 


2 


RBSC 


3 


TSSC 


4 


DISC 


5 


NSSC 


6 


SSSC 


7 


MASC 


10 


CTSC 


11 



IOSC 


12 


use 


13 


I2SC 


14 


I3SC 


15 


DSSC 


77 



Description 

System service class. All jobs initiated by the system, 
except for maintenance jobs and subsystems, are assigned to 
this service class . 

Batch service class . 

Remote batch service class. 

Interactive service class. 

Detached interactive service class. 

Network supervisor service class. 

Subsystem service class. 

Maintenance service class. 

Communication task service class. All SCOPE 2 Station 
Facility spun-off task (SPOT) jobs and RHF service jobs are 
assigned to this service class. 

Installation service class 0. 

Installation service class 1. 

Installation service class 2. 

Installation service class 3. 

Deadstart sequencing service class. 



Default Service Classes 

The system assigns an initial default service class to each job and each output file. The 
default value depends on the job or file's origin type. Your site may choose to change its 
default service classes from these released defaults. 





Default Service 


Origin 


Class 


SYOT 


SYSC 


BCOT 


BCSC 


RBOT 


RBSC 


IAOT 


TSSC 
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DEVICE TYPES 

The following device types are supported by NOS: 

Mnemonic Code (Octal) Display Equipment 

885-42 Disk Storage Subsystem (one to three units, full- track) . 

834 Disk Storage Subsystem (one to eight units, full-track). 

Extended memory. 

844-21 Disk Storage Subsystem (one to eight units, half-track). 

844-4x Disk Storage Subsystem (one to eight units, half-track). 

844-21 Disk Storage Subsystem (one to eight units, full- track) . 

844-4x Disk Storage Subsystem (one to eight units, full-track). 

885-lx Disk Storage Subsystem (one to three units, half-track). 

Distributive data path to extended memory. 

885-lx Disk Storage Subsystem (one to three units, full- track) . 

819 Disk Storage Subsystem (one unit, full-track; model 176 
only) . 

DW 0427 819 Double Density Disk Storage Subsystem (one unit, full-track; 

model 176 only). 

Seven-track magnetic tape drive. 

Null equipment. 

Nine- track magnetic tape drive. 

Interactive terminal. 



DB 


0402 


DD 


0404 


DE 


0405 


Din 


0411 


DJn 


0412 


DKn 


0413 


DLn 


0414 


DMn 


0415 


DP 


0420 


DQn 


0421 


DV 


0426 



MT 


1524 


NE 


1605 


NT 


1624 


TT 


2424 
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ERROR FLAGS 



NOS sets the following error flags in the user job's control point area. The user program 

can rexer to ensue J.x_gi- uuL_ug eti^i c&il piuuessiug \.jLei.e.L i_u t_i«_ _u.au uiciclu hi 

sec tion 6 ) • 



Error Flag 




(Octal) 


frbemonict 


1 


TIET 


2 


TAET 


3 


ARET 


4 


ITET 


5 


PSET 


6 


PPET 


7 


CPET 


10 


PCET 


11 


— 


12 


MIET 


13 


TI£T 


14 


FLET 


15 


TKET 


16 


SRET 


17 


FSET 


20 


RCET 


21 


ODET 


22 


IDET 


23tt 


— 


24 


RRET 


25 


DRET 


26 


STET 


27 


OKET 


30 


— 


31 


SVET 


32 


SSET 


33 


ECET 


34 


PEET 



Description 

User break 1 . 

User break 2. 

Arithmetic error. 

SCP invalid transfer address. 

A program stop was encountered by the CPU. 

PP abort. A PP program requested that the job be aborted (CIO 

or PFM, for example). 

CPU abort. The job issued an ABT request. 

PP call error. The job called a nonexistent or illegal system 

request . 

Reserved for installations. 

Message limit . 

Time limit. Job is allowed an additional 1 to 10 seconds of 

CPU time for error processing. 

File limit. The job attempted to assign more active files to 

the job than are allowed by the validation parameter. 

Track limit. The job requested mass storage space on a device 

with none available. 

SRU limit. The j ob is allowed an additional 10 SRUs to 

complete error exit processing. 

Forced error . 

Job hung in auto recall . 

The operator dropped the job. 

Idle down. 

Reserved for installations . 

Job rer un . 

Deadstart rerun. 

Suspension timeout (EJT error flag only) . 

Operator killed job. 

Reserved . 

Security conflict. 

Subsystem abort. 

ECS parity error. 

CPU or CM parity error .ttt 



tin order to use the mnemonic in a COMPASS program, the program must contain an SST 
pseudo-instruction, and you must specify either systems text PPTEXT or NOSTEXT. 
ttlhe symbol SPET has a value of 23g. Error flags whose value is greater than that of SPET 
are considered special errors. 
1"ft Applicable to CYBER 170 Computer Systems only. 
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35 


SYET 


36 


RAET 


37 


RSET 


40 


ORET 


Al-77 


— 



Error Flag 
(Octal) Mnemonic'' Description 

System abort. 

Recovery abort. 

Subsystem recovered during level 3 deadstart. 

Override of error condition. 

Reserved. 

Errors greater than or equal to SPET (23s) are considered special by certain system 
routines. Examples of this are as follows. 

• The job advancement routine 1AJ does not invoke buffer flushing when an error occurs 
that is SPET or greater. 

• Read and write tape error recovery is terminated by an error greater than or equal 
to SPET. 

• CIO terminates a skip operation prior to completion if the error is SPET or greater. 

• Waiting for a tape to be mounted and waiting for track limit terminate only on 
operator drop (ODET) or an error of value SPET or greater. 



tin order to use the mnemonic in a COMPASS program the program must contain an SST pseudo- 
instruction, and you must specify either systems text PPTEXT or NOSTEXT. 
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CPU COMMON DECKS 



Appendix t' lists the CPU common decks of general iuteiest lu luc our-iriioo prugi 
including a list of those common decks that are available in relocatable form on the system 
library (SYSLIB). You can obtain documentation of all CPU common decks provided with the 
system OPL by entering the following commands after accessing the system OPL.f 

MODIFY, Z./*EDIT,CALLCPU 
DOCMENT. 

In addition, by using the KRONREF utility to determine which common decks are associated 
with which programs, you can examine the program listings to obtain examples of the use of 
particular common decks. 

Since common decks are continually being changed or updated, it is impossible to maintain a 
complete and current description of each common deck in this appendix. Thus, you should 
consult system listings as described above for specific information. 



CPCOM 

The CPCOM common deck contains macros for commonly used system requests. The macros 
contained in CPCOM are available in systems texts NOSTEXT and SYSTEXT. Therefore, you can 
access these macros either through the system OPL or by specifying the alternate systems 
text NOSTEXT or SYSTEXT. 



The following CPCOM macros are described in the indicated sections. 



Macro Name 

ABORT 

APPEND 

ASSIGN 

ATTACH 

BKSP 

BKSPRU 

CHANGE 

CLOCK 



Description 
Abort program 
Append file to file 
Access library file 
Attach direct access file 
Backspace file by logical record 
Backspace file by physical record 
Alter permanent file attributes 
Get time of day 



Section 
11 
5 

4 
5 
3 
3 

5 
9 



tYour site must control access to the system OPL as required by. the site's licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the 
system OPL. 
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Macro Name Description 

CLOSE Terminate operations on file 

CLOSER Close magnetic tape reel 

CONTROL Read and/or execute command 

DATE Get current date 

DEFINE Create direct access file 

ENDRUN Request normal program termination 

EREXIT Specify error processor address 

EVICT Release file space, save attachment 

FILEB Create FET for binary sequential file 

FILEC Create FET for coded sequential file 

FILINFO Get file information 

GET Get copy of indirect access file 

HTIME Get model 176 clock cycle count 

JDATE Get current Julian date 

LABEL Assign file to magnetic tape 

LOCK Prevent writing on file 

MEMORY Set amount of memory for job 

MESSAGE Send message to console and dayf ile 

MOVE Move block of data 

OFFSW Clear sense switches 

OLD Get copy of indirect access file as primary file 

ONSW Set sense switches 

OPEN Create file or get file information 

OVERLAY Process request to LDR processor 

OVWRITE Overwrite file with binary pattern 

PDATE Get packed date and time 

PERMIT Permit other user to access file 

POSMF Open or position multifile 

PURGE Remove permanent file from system 



Section 

3 

3 
10 

9 

5 
11 

6 

3 

2 

2 

4 

5 

9 

9 

4 

4 
11 
11 
11 

6 

5 

6 

3 
11 

3 

9 

5 

3 

5 
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Appendix F lists the CPU common decks of general interest to the COMFASS programmer, 
including a list of those common decks that are available in relocatable form on the system 
library (SYSLIB). You can obtain documentation of all CPU common decks provided with the 
system OPL by entering the following commands after accessing the system OPL.f 

MODIFY , Z . /*EDIT, CALLCPU 
DOCMENT. 

In addition, by using the KRONREF utility to determine which common decks are associated 
with which programs, you can examine the program listings to obtain examples of the use of 
particular common decks. 

Since common decks are continually being changed or updated, it is impossible to maintain a 
complete and current description of each common deck in this appendix. Thus, you should 
consult system listings as described above for specific information. 



CPCOM 

The CPCOM common deck contains macros for commonly used system requests. The macros 
contained in CPCOM are available in systems texts NOSTEXT and SYSTEXT. Therefore, you can 
access these macros either through the system OPL or by specifying the alternate systems 
text NOSTEXT or SYSTEXT. 



The following CPCOM macros are described in the indicated sections. 



Macro Name 

ABORT 

APPEND 

ASSIGN 

ATTACH 

BKSP 

BKSPRU 

CHANGE 

CLOCK 



Description 
Abort program 
Append file to file 
Access library file 
Attach direct access file 
Backspace file by logical record 
Backspace file by physical record 
Alter permanent file attributes 
Get time of day 



Section 

11 
5 
A 
5 
3 
3 
5 
9 



tYour site must control access to the system OPL as required by. the site's licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the 
system OPL. 
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Macro Name Description 

CLOSE Terminate operations on file 

CLOSER Close magnetic tape reel 

CONTROL Read and/or execute command 

DATE Get current date 

DEFINE Create direct access file 

ENDRUN Request normal program termination 

EREXIT Specify error processor address 

EVICT Release file space, save attachment 

FILEB Create FET for binary sequential file 

FILEC Create FET for coded sequential file 

FILINFO Get file information 

GET Get copy of indirect access file 

HTIME Get model 176 clock cycle count 

JDATE Get current Julian date 

LABEL Assign file to magnetic tape 

LOCK Prevent writing on file 

MEMORY Set amount of memory for job 

MESSAGE Send message to console and dayf ile 

MOVE Move block of data 

OFFSW Clear sense switches 

OLD Get copy of indirect access file as primary file 

ONSW Set sense switches 

OPEN Create file or get file information 

OVERLAY Process request to LDR processor 

OVWRITE Overwrite file with binary pattern 

PDATE Get packed date and time 

PERMIT Permit other user to access file 

POSMF Open or position multifile 

PURGE Remove permanent file from system 



Section 

3 

3 
10 

9 

5 
11 

6 

3 

2 

2 

4 

5 

9 

9 

4 

4 
11 
11 
11 

6 

5 

6 

3 
11 

3 

9 

5 

3 

5 
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Macro Name 



Description 



Section 



READ Read data into circular buffer 3 

READC Read coded line from circular buffer into working buffer 3 

READCW Read PRUs bounded by control words 3 

READEI Read data to EOI 3 

READH Read coded line from circular buffer into working 

buffer with space fill 3 

READLS Read logical records from list 3 

READN Read S or L format tape data 3 

READNS Read file to EOF 3 

READO Read word from circular buffer into register X6 3 

READS Read and unpack coded line from circular buffer into 

string buffer 3 

READSKP Read until buffer full or EOR or EOF is encountered 3 

READW Read specified number of words from circular buffer 

into working buffer 3 

RECALL Relinquish CPU temporarily 11 

RENAME Change name of local file 4 

REPLACE Replace indirect access file with contents of local file 5 

REQUEST Assign file to device 4 

RETURN Release file from job 3 

REWIND Rewind file 3 

REWRITE Write data as random function 3 

REWRITEF Write entire circular buffer to file as random function, 

end with EOF 3 

REWRITER Write entire circular buffer to file as random 

function, end with EOR 3 

RFILEB Create FET for binary random file 2 

RFILEC Create FET for coded random file 2 

ROUTE Dispose local file to queue 7 

RPHR Transfer PRU into circular buffer 3 

RPHRLS Read PRUs from list 3 
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Macro Name 



Description 



Section 



RTIME Get real-time clock reading 

SAVE Save file as indirect access file 

SETFS Set file status 

SETPFAC Set permanent file security access categories 

SETPFAL Set permanent file security access level 

SKIPB Backspace file by records 

SKIPEI Skip to EOI of file 

SKIPF Skip file forward by records 

SK1PFB Backspace file by files 

SKIPFF Skip file forward by files 

STATUS Determine if file exists 

STIME Get job's accumulated SRUs 

SYSCOM Define system communication symbols 

SYSTEM Process system request 

TIME Get job's accumulated CP time 

UNLOAD Release file from job; do not decrement resource count 

UNLOCK Clear write lockout bit for file 

USECPU Select CPU for processing 

USERNUM Get user name 

WAIT Relinquish CPU for specified time 

WPHR Write physical record from circular buffer 

WRITE Write circular buffer to file 

WRITEC Write coded line image to circular buffer from working 
buffer 

WRITECW Write PRUs bounded by control words from circular buffer 

WRITEF Write entire circular buffer to file, end with EOF 

WRITEH Pack string buffer to coded line image and write to 
circular buffet, deleting trailing spaces 

WRITEN Write circular buffer to S or L tape 

WRITEO Write one word from register X6 to circular buffer 



9 
5 
4 
5 
5 
3 
3 
3 
3 
3 
4 
9 
1 

11 
9 
3 
4 
6 
6 

11 
3 
3 

3 
3 
3 

3 
3 
3 
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Macro Name 



Description 



Section 



WRITER 
WRITES 



Write entire circular buffer to file, end with EOR 
Pack string buffer to coded line image and write to 



WRITEW 



Write specified number of words from working buffer to 
circular buffer 



COMCMAC 

The COMCMAC common deck contains macros (not available in SYSTEXT) for issuing system 
functions for system-oriented programs. The common decks for the processors used must also 
be called by the user program. 

The macros defined in common deck COMCMAC are available in systems text PSSTEXT. Therefore, 
you can access these macros either through the system OPL or by specifying the alternate 
systems text PSSTEXT. 

The following COMCMAC macros are described in the indicated sections. 



Macro Name 
CATLIST 
CHECKPT 
CSET 
DAYFILE 
DISTC 
EDATE 
EFFECT 
ENCSF 
ETIME 
EXCST 
GETASL 
GETCN 
GETFLC 
GETFNT 
GETGLS 
GETJA 
GETJAL 
GETJCR 
GETJN 
60459690 D 



Description 
Catalog user's permanent files 
Create checkpoint dump 
Set terminal character set mode 
Access dayfile 
Disable terminal control 
Edit packed date 
Set/clear format effector mode 
Enter new command file 
Edit packed time 
Execute command 
Get account block SRU limit 
Get charge and project numbers 
Read field length control word 
Get FNT/FST entry table 
Get global library set 
Get job accounting words 
Get job security access level 
Get job control registers 
Get job sequence name 



Section 

5 
10 
11 
11 
11 

9 
11 

4 

9 
10 

6 

6 

6 

4 

6 

6 

6 

6 

6 
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Macro Name 



Description 



Section 



GETJO 

GETJOSC 

GETJSL 

GETLC 

GETMC 

GETPAGE 

GETPFP 

GETPR 

GETRI 

GETSS 

GETSSID 

GETSSM 

vrEi 'i'Li 

GETUSC 

LOADD 

LOADQ 

NORERUN 

PRIMARY 

PROMPT 

PSCSF 

RERUN 

ROLLOUT 

SETFAL 

SETGLS 

SETJAL 

SETJCR 

SETJOB 

SETLC 

SETPAGE 

SETPR 

SETSC 



Get job origin code 6 

Get job origin and service class codes 6 

Get job step SRU limit 6 

Get loader control word 6 

Get machine characteristics 11 

Get page size parameters 6 

Get permanent file parameters 6 

Get CPU priority 6 

Get reprieve information 6 

Get subsystem 6 

Get subsystem identifier 6 

Get system security mode 11 

Read job step time limit 6 

Get user service class 6 

Load fast dynamic load capsule directory 11 

Load fast dynamic load capsules 11 

Clear rerun status 11 

Make file primary 4 

Disable/enable terminal prompt 11 

Position command file 4 

Set rerun status 11 

Roll out job 6 

Set file security access level 4 

Set global library set 6 

Set job security access level 6 

Set job control registers 6 

Set user job name 6 

Set loader control word 6 

Set page size parameters 6 

Set CPU priority 6 

Set service class 6 
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Macro Name 


Description 


SETSLM 


Set screen/line mode 


SETSS 


Set subsystem 


SETSSM 


Set secure system memory 


SUBR 


Create subroutine tag 


T STATUS 


Return terminal status 



Section 

11 

6 

6 

11 

12 



COMCCMD 

The COMCCMD common deck contains macros (not available in SYSTEXT) for issuing special job 
control and accounting function requests. 

The macros defined in common deck COMCCMD are available in systems text PSSTEXT. Therefore, 
you access these macros either through the system OPL or by specifying the alternate text 
PSSTEXT. 

The following COMCCMD macros are described in the indicated sections. 



Macro Name Description 

GETACT Get outstanding system activity 
information 

GETEM Get current exit mode 

GETJCI Get job control information 

GETLIDA Get LID attributes 

GETLOF Get list of files pointer 

GETLVL Get PSR level of NOS 

MACHID Get machine identification 

MODE Set exit mode flags 

PACKNAM Request pack name 

PROTECT Set extended memory field length 

preservation and/or user file privacy 

REPRIEVE Set reprieve processing 

RPVBLK Create reprieve parameter block 

SETASL Set account block SRU limit 

SETFET FET modification macro 

SETJCI Set /clear job control parameters 

SETJSL Set job step SRU limit 
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Section 
6 

6 
6 
11 
6 
6 
6 
6 
6 
6 

10 
10 

6 

2 

6 
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Macro Name 



Description 



Section 



SETLOF 

SETMFL 

SETRFL 

SETTL 

SHELL 

VERSION 



Set list of files pointer 

Set job maximum field length 

Set job step initial field length 

Set job step time limit 

Set controls for shell program 

Get operating system version name 



6 
6 
6 
6 
6 
6 



OTHER COMMON DECKS 

The following common decks are also available to you on the system OPL. 

Common Deck Description 

COMCARGt Processes an argument list by the use of an equivalence table. 

COMCARM Processes multiple word arguments. 

COMCCDDt Converts a binary integer to display code decimal digits with leading 
zero suppression. 

COMCCFDt Converts a 30-bit integer to display code in FORTRAN F10.3 format. 

COMCCHD Converts up to a 10-digit decimal number (40 bits) to hexadecimal 
display code with leading zero suppression. 

COMCCIOt Performs I/O functions. 

COMCCODt Converts a binary integer to display code octal digits with leading 
zero suppression. 

COMCCPAt Converts positional arguments in an input string to keyword arguments 
in an output string. 

COMCCPM Calls the PP program CPM to perform tasks involving control point 
activity. 

COMCCPTt Copies prefix table comments to a print line. 

COMCCVI Contains formulas for converting validation index value to limit value. 

COMCCVL Common validation interface processor. 

COMCDCM Display console communication macros. 

COMCDCP Display console communication processor. 

COMCDXBt Converts one word of display code digits to a binary value. 

COMCECM Contains macro definitions for performing interpretive mode extended 
memory reads and writes (refer to appendix D). 

fThis common deck is also available on the program library (PL) that contains the common 
common decks. Contact site personnel for further information. 
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Common Deck 



Description 



COMCECS 

COMCEDT 

COMCFCE 
COMCGTO 

COMCHXB 

COMCLFM 
COMCLOD 
COMCMTMt 

COMCMTPt 

COMCMVEt 

COMCOVL 

COMCPFM 

COMCPOP 

COMCRDCt 

COMCRDHt 

COMCRDOt 
COMCRDSt 

COMCRDWt 

COMCRSP 

COMCSFM 

COMCSFNT 

COMCSNM 

COMCSRTt 



Processes interpretive mode extended memory read and write instructions 

/ C *. J-J__ T\\ 

Edits an 18-bit packed date or time into a 10-character display coded 
date or time 

Edits a permanent file catalog entry into a three-line output formula 

Returns the terminal ordinal corresponding to the supplied terminal 
mnemonic or the terminal mnemonic corresponding to the supplied 
terminal ordinal 

Converts one word of hexadecimal display code digits to a binary value; 
leading and trailing blanks are ignored 

Processes requests for the PP program LFM 

User call loader interface 

Contains macro for generation, allocation, and processing of managed 
tables 

Contains routines for processing managed tables 

Moves a block of data 

Requests the PP program LDR to load a specified overlay 

Performs permanent file action functions by calls to the PP program PFM 

Obtains parameters from a string buffer 

Reads one coded line from a CIO buffer to a working buffer 

Reads one coded line from a CIO buffer to a working buffer with 
trailing space fill 

Reads one word from a CIO buffer to the X6 register 

Reads one coded line from a CIO buffer to a working buffer where it is 
stored one character per word 

Reads the specified number of words from a CIO buffer to a working 
buffer 

Removes secure parameters from command 

Processes requests for the PP program SFM 

Replaces trailing 00 codes with 55 codes in a word 

Sets name in message 

Identifies the format of a record from the first 64 words located in a 
working buffer 



tThis common deck is also available on the program library (PL) that contains the common 
common decks. Contact site personnel for further information. 
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Common Deck 
COMCSSN 
COMCSSTt 
GOMCSTFt 
COMCSYSt 
COMCUPCt 
COMCUSB 
COMCVDT 

COMCVLC 

COMCWODt 

COMCWTCt 

COMCWTHl" 

COMCWTOt 
COMCWTSt 

COMCWTWt 

COMCZAP 

COMCZTBt 



Description 

Skips a sequence number on a coded line if present 

Sorts a table into ascending order using a shell-sorting technique 

Determines if a file is, or will be, assigned to a terminal 

Contains routines for processing system request 

Unpacks a command to individual parameters 

Unpacks data block to string buffer 

Converts a display-coded date (yymmdd) or time (hhmmss) to a packed 
binary value and checks the validity of the entry 

Converts an access level or access category name to the corresponding 
binary value, or vice versa 

Converts a word to octal display code by an in-line sequence of shifts 
and masks 

Transfers one coded line in C format from a working buffer to a CIO 
buffer 

Transfers one coded line in H format from a working buffer to a CIO 
buffer; trailing spaces are deleted 

Writes one word to a CIO buffer from X6 

Transfers one coded line from a string buffer to a CIO buffer with 
trailing space suppression 

Transfers data from a working buffer to a CIO buffer 

Z argument command processor 

Replaces all 00 codes with 55 codes in a word 



SYSLIB 

The following common decks, unless otherwise noted, are assembled from the PL that contains 
the common common decks and are available in relocatable form on the system library SYSLIB. 



Common Deck 
COMCCIO 
COMCCPMtt 



Entry Points 
CI0= 
CPM= 



Description 
I/O function processor 
Control point manager processor 



tThis common deck is also available on the program library (PL) that contains the common 

common decks. Contact site personnel for further information. 
ttAssembled from the system OPL. 
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Common Deck 


Entrv Points 


COMCECst 


REC=, WEC= 


COMCLFMt 


LFM= 


COMCMVE 


MVE= 


COMCOVLt 


OVL= 


COMCPFMt 


PFM= 


COMCRDC 


RDC= 


COMCRDH 


RDH= 


COMCRDO 


RDO= 


COMCRDS 


RDS= 


COMCRDW 


LGB=, RDW=, RDX= 


COMCSYS 


MSG=, RCL=, 




SYS=, WNB= 


COMCWTC 


WTO 


COMCWTH 


WTH= 


COMCWTO 


WTO= 


COMCWTS 


WTS= 


COMCWTW 


DCB=, WTW=, WTX= 



Description 
Extended memory interpretive mode macro processors 
Local file manager processor 
Move block of data 
Overlay load processor 
Permanent file processor 
Read coded line, -C- format 
Read coded line, -H- format 
Read one word 

Read coded line to string buffer 
Read words to working buffer 
Process system request 

Write coded line, -C- format 
Write coded line, -H- format 
Write one word 

Write coded line from string buffer 
Write words from working buffer 



'Assembled from the system OPLi 
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BINARY FORMATS 



Appendix G describes the following binary formats. 

pp CYBER 180, CYBER 170, CYBER 70, or 6000 Computer Systems PP absolute program 

0PL Modify old program library deck 

0PLD Program library directory 

ULIB User library group 

TEXT Unrecognized as binary 

PROC Procedure 

Compressed compile file 

For binary formats of loader and tables, refer to the CYBER Loader Version 1 Reference 
Manual . 

PP— CYBER 180, CYBER 170, CYBER 70, OR 6000 COMPUTER SYSTEMS 
PP ABSOLUTE 

Binary output for a CYBER 170, CYBER 70, or 6000 Computer Systems PP program or overlay is a 
logical record that may contain the following: 

• Prefix table 

• CYBER 170, CYBER 70, or 6000 Computer Systems PP program control table 

• PP text in five PP words per 60-bit CPU word 
The format of the control table is: 



59 




41 


35 




23 




11 




O 


name 


00 


fwa 


OOOO 


length 



Bits 



Field 



59-42 name 

41-36 none 

35-24 fwa 

23-12 none 

1 1-0 length 



Description 

Program name, one- to three-display code characters, left-justified 
with zero fill. 

Reserved for future system use. 

Origin minus 5; address at which the header word is loaded.t 

Reserved for future system use . 

Number of CPU words in program image (1/5 the number of PP words). 



tThe normal origin address for PP programs is HOOg (PPFW); however, the origin address 
should be greater than 5. 
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OPL— MODIFY OLD PROGRAM LIBRARY DECK 

A Modify old program library deck is a record on a Modify library file (figure G-l) 
consisting of a prefix table, a modification table, and text. The prefix table contains the 
library creation date in word 2 and the latest modification date in word 3. 



— ■» 



prefix table 1 



modification tables 



text* 



End -of- record i 



prefix tableg 



modification table; 



text 2 



End-of-recordg 



prefix table-> 



End -of- record n 



prefix lable ntl 



directory 



End -of- record n+1 
End -of -information 



Deck (record)-) 



Deck (record) 2 



J 



End -of- record,, _i 


prefix table n 


modification table n 


text n 



Deck (record) n 



Figure G-l. Modify Library File Format 
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MODIFICATION TABLE FORMAT 

Modification table format is shown in figure G-2. 





59 




47 






17 






11 







Word 


700x 


reserved 


n 


1 


modnome. 


'v 





2 


nftodnomeo 


*, 


1 





3 J 


> 








* 












V 



Figure G-2. Modification Table Format 





• 






V. 


n-1 


modnome . 


\ 


y 





n 


modname n 


'', 


y 






Word Bit(s) Field 

ID 59-48 700X 



47-12 none 
11-0 n 

wordi 59-18 modnamei 



16 



yi 



Description 

Identifies Modify deck. Least significant digit 
indicates whether or not the deck is common as follows: 

1 Deck is not common. 

2 Deck is common. 

Reserved for future system use. 

Nimber of modification names in table. 

One- to seven-character modification set name. Each 
modification to a deck causes a new entry in this table. 

YANK flag: 

Modifier not yanked. 

1 Modifier yanked. 
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TEXT FORMAT 

Text Is an indefinite number of words that contain a modification history and the compressed 
image of each line in the deck. Text for each line is in the format shown in figure G-3. 





59 53 




35 


17 







^ 


a 


wc 


seq. no. 


mht>i 


mhb2 




m 


mhb3 


mhb4 


mhbic 


<% 




• 
• 

4 






compressed text 

















Figure G-3. Modify Text Format 



Bit(s) Field 



Description 



59 



Activity bit: 



Line is inactive. 

1 Line is active. 



58-54 


wc 


53-36 


seq. no. 


35-18 


mhbj 


and 




subse- 




quent 




18-bit 




bytes 





Number of words of compressed text. 

Sequence number of card (octal) according to the position 
in the deck or modification set. 

Modification history byte. Modify creates a byte for 
each modification set that changes the status of the 
card. Modification history bytes continue to a zero byte. 
Since this zero byte could be the first byte of a word 
and the compressed card image beings a new word, the 
modification history portion of the text could terminate with a 
zero word. 



The format of mhbj i s ; 



17 



',* 



mod. no. 



a Activate bit: 

Modification set deactivated the card. 

1 Modification set activated the card. 

mod. no. Index to the entry in the modification table 
that contains the name of the modification 
set that changed the card status. 
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Following the modification history bytes is the compressed image of the card in display 
code. A single space is represented by 55g; it is not compressed. Two or more embedded 
spaces are replaced in the image as follows: 

3 spaces replaced by 0002 

4 spaces replaced by 0003 



64 spaces replaced by 0077g 

65 spaces replaced by 007755g 

66 spaces replaced by 00770001g 

67 spaces replaced by 00770002g, etc. 

Trailing spaces are not considered as embedded and are not included in the card image. A 
12-bit zero byte marks the end of the card. 



NOTE 



Existing 63-character set program libraries 
may have two spaces represented as a 0001 
byte. 



OPLD— PROGRAM LIBRARY DIRECTORY 

The library file directory (figure G-4) contains a prefix (7700) table followed by a table 
containing a two-word entry for each deck in the library. Directory entries are in the same 
sequence as the decks on the library. 





59 




47 29 


17 







ID WordO 
1 
2 
3 
4 

«■ 

len-1 
len 


7000 





'en 




decknamei 


type. 


p 1 


random address <| 


decknomeg 


type 2 


P2 


random addressg 


^ 
■» 




• 
• 
• 




*. 
t* 


deckname len/2 


type len/2 


p len/2 


random address len/2 

















Figure G-4. Library File Directory Table 
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ID 


59-48 


7000 




17-0 


len 


1,3, 


59-18 


dec kname- 


• • « » 






len-1 







Word Bits Field Description 

Identifies the table as a program library directory. 

Directory length excluding ID word. 

i Name of the program library deck; one to seven characters, 
left- justified. If type ± equals 16g, this field 
contains the capsule name. 

17-0 typej Type of record (octal): 

Unrecognizable as binary program (TEXT). 

1 Peripheral processor program (PP) . 

3 Relocatable central processor program (REL). 

4 Central processor overlay (OVL) . 

5 User library program (ULIB). 

6 Old program library deck (OPL) . 

7 Old program library common deck (OPLC). 

10 Old program library directory (OPLD) . 

11 Multiple entry point overlay (ABS). 

12 Peripheral processor unit program (PPU). 
16 Fast dynamic load capsule (CAP). 

*>n T» — ~ 3--__ /Tmr\n\ 

2,4, 59-30 Pi Zero for all record types except CAP (16g). If typej 

...,len equals 16g this field is defined as follows. 

Bits Description 

59-48 Ordinal to group name in ULIB record (refer 

to ULIB record) . 
47-30 Length of capsule. 

29-0 random Address of the deck relative to the beginning of the file, 

address^ 
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ULIB— USER LIBRARY GROUP 



A user library group (figure G-5) consists of all records beginning with a ULIB-type record 
through the next QPLD— t vn e records The ULIB record forms 
ULIB deck entry/ externals format is shown in figure G-7. 



through the next QPLD— t vn e records The ULIB record format is shown in f i°ure G— 6 and th 











PREFIX TABLE 




ULIB RECORD 




END-OF-RECORD 






DECK., 






END-OF-RECORD 






DECK 2 






END-OF-RECORD 




DECKo J 

t " T 




END-OF-RECORD 






DECK n 






END-OF-RECORD 






OPLD RECORD 






END-OF-RECORD 





Figure G-5. User Library (ULIB) Format 
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59 



53 47 41 35 



77 00 



0016 



29 23 17 11 

0000 0000 0000 



library name 



yy 



dd 



J 



Prefix 
Table 



59 



53 47 



35 



17 



11 



76 



I- 



gc 
ra 

f 



group 
name^ 

capsule 
count* 



00 



gc 



ra 



group name, 



group name g 



capsule count 1 



capsule count g 



group name m 



capsule count m 



Deckj Entry/Externals Table 



< 



Deck;? Entry/Externals Table 



•A, 



Deck n Entry/Externals Table 



ULIB 
Table 



Group count (count of different group names in ULIB) equal to m. 
Random address of OFLD. 
Cross-reference flag: 

ULIB table contains cross-references. 

1 ULIB table does not contain cross-references. 

Name of group. 

Number of capsules with group name^ . 



Figure G-6. ULIB Record Format 
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59 




29 


17 


entry 1 


W//////////M 


entry 2 


W///////////A 


■% 






■i 



entry x 




random address of deck; 



random address of external 



random address of external 



random address of external 



Figure G-7. ULIB Deck Entry /Externals Format 



TEXT— UNRECOGNIZED AS BINARY 

A text record Is any record that cannot be recognized as conforming to a specific binary 
format. The record name is taken from the first one through seven display code characters 
in the record (if a prefix table is present, the record name will be taken from that table 
instead). 



PROC— PROCEDURE 

A PROC record is a special form of text record in which the first line has the following 
format: 

.PROC,procnam 

The record name is the one- through seven-character alphanumeric identifier procnam. 
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COMPRESSED COMPILE FILE 

A compressed compile file (figure G-8) has a one-word header. 





59 


47 35 17 11 






ID Word 
1 

2 


7700 


00 16 


chor. set 





■» 


modname.) 


seq. no..] 


compressed line 1 




• 
• 


modname n 


seq. no. n 


compressed line n 


c nar set 


Character set of the compressed compile file: 

63-character set. 
64 64-character set. 




modname^ 


One- to seven-character modification set name. 




seq. no^ 


Sequence number of the line image according to the position in the deck 




or modification set. 





Figure G-8. Compressed Compile File Format 
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EXAMPLES OF RANDOM I/O H 



• Create a random file 

• Read a random file with list 

• Write (replacing records) on a random file 

The COMPASS program illustrated in figure H-l reads the input deck in figure H-2 and creates 
a random file in the format illustrated in figure H-3. The resulting index directory record 
is also illustrated. 

An example of a program which uses the READLS (read with list) macro to retrieve (read) a 
list of records from the same random file is illustrated in figure H-4. 

Figure H-5 illustrates two ways of writing (replacing) records on a random file. The new 
record 1 is written at EOI; that is, at the same random address. Record 3 is written to the 
file by using the REWRITER macro, which rewrites in place. 



60459690 A H-l 



CREATE 








IDENT 


CREATE, FWA 




ABS 






SST 






TITLE 


CREATE - CREATE RANDOM FILE. 




ENTRY 


CREATE 




ENTRY 


RFL= 




SYSCOM 


B1 


•COMMENT 


CREATE 


RANDOM FILE. 




COMMENT COPYRIGHT CONTROL DATA 1982. 




SPACE 


4, 10 


*** 


CREATE 


- CREATE RANDOM FILE. 


* 


PROGRAMMER NAME. 82/04/26. 




SPACE 


4, 10 


*** 




THIS PROGRAM CREATES A RANDOM FILE AND DIRECTORY FROM 


* 


DATA SUPPLIED ON FILE INPUT. 


* 


FORMAT 


OF INPUT - 


* 




CARD 1 COLUMN 1-2 RECORD NUMBER RIGHT JUSTIFIED 


* 




CARD 1 COLUMN 11-20 RECORD NAME 


* 




CARD 2-N COLUMN 1-80 RECORD DATA 


* 




CARD N EOR 


* 




REPEAT SEQUENCE - 


* 




MAX. 64 RECORDS 


"it 
* 


FILE IS WRITTEN TO RANFILE. 




SPACE 


4, 10 


*** 

* 
* 


DAYFILE MESSAGES. 


* INDEX OUT OF RANGE.* = INDEX INPUT .GE. 64. 


* 


* RANDOM FILE CREATED.* = PROGRAM COMPLETE. 




SPACE 


4, 10 


** 


PROGRAM CONSTANTS. 


IBUFL 


EQU 


101 B INPUT BUFFER LENGTH 


INDL 


EQU 


101B INDEX LENGTH 


WBUFL 


EQU 


10B WORKING STORAGE BUFFER LENGTH 


RBUFL 


EQU 


1001B FILE CREATION BUFFER 




TITLE 


MAIN PROGRAM. 




ORG 


110B 


FWA 


BSS 





I 


BSS 


INPUT FET 


INPUT 


FILEB 


IBUF, IBUFL 


R 


BSS 





RANFILE 


RFILEB 


RBUF,RBUFL,(IND=INDEX,INDL) 


MAXI 


CON 


MAXIMUM INDEX 


CREATE 


SB1 


1 




REWIND 


R 


CR1 


READ 


I,R READ NEXT RECORD 




READO 


I 




NG 


X1,CR4 IF END OF FILE 




MXO 


12 




BX5 


X0*X6 



Figure H-l. COMPASS Program to Create a Random File (Sheet 1 of 3) 
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SB? BO SET OCTAL CONVERSION 

RJ DXB CONVERT DIGIT 

NZ X4,ERR IF ERROR IN RECORD NUMBER 

BX5 X6 SAVE RECORD NUMBER 



RECALL R 
READ" I 



rti- a i\ r>r f*nnr\ tiitur 



NG 

MXO 

SA1 

LX1 

BX6 

BX1 

BX6 

SA6 

SA1 

1X1 

PL 

BX6 

SA6 

READC 

NG 

NZ 



:r4 



IF END OF FILE 

SET ADDRESS OF RECORD IN INDEX 



IF NOT LARGEST INDEX 
SET NEW MAX. INDEX 



X1, 

42 

R+6 

30 

X0*X6 

-X0*X1 

X6+X1 

INDEX+X5 

MAX I 

X1-X5 

X1 ,CR2 

X5 

A1 
CR2 READC I,WORK,WBUFL 

X1,CR4 IF END OF FILE 

X1,CR3 IF END OF RECORD 
WRITEC R,WORK,WBUFL 
EQ CR2 

CR3 WRITER R 

EQ CR1 READ NEXT RECORD 

** WRITE INDEX, 

CR4 RECALL R 

SA1 MAX I 

WRITEW R,INDEX,X1+1 

WRITER R,R 

WRITEF R,R 

REWIND R 

MESSAGE (=C*RANDOM FILE CREATED.*) ,,R 

ENDRUN 

ERR MESSAGE (C=*INDEX OUT OF RANGE.*) ,,R 
ABORT 

SPACE 4, 10 
** COMMON DECKS. 



*CALL 


COMCRDO 


♦CALL 


COMCCIO 


•CALL 


COMCWTW 


•CALL 


COMCWTC 


•CALL 


COMCRDC 


•CALL 


COMCSYS 


•CALL 


COMCRDW 


•CALL 


COMCDXB 




Figure H-l 



COMPASS Program to Create a Random File (Sheet 2 of 3) 
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USE 


LITERALS 


** 


BUFFERS. 


INDEX 


BSSZ 


INDL INDEX BUFFER 


IBUF 


EQU 


* INPUT BUFFER 


RBUF 


EQU 


IBUF+IBUFL RANDOM FILE BUFFER 


WORK 


EQU 


RBUF+RBUFL WORKING BUFFER 


RFL= 


EQU 
END 


WORK+WBUFL JOB FL 



Figure H-l. COMPASS Program to Create a Random File (Sheet 3 of 3) 



10 


REC10 


THIS IS 


RECORD 


NUMBER 10. 


-EOR- 






03 


REC3 




THIS IS 


RECORD 


NUMBER 3. 


-EOR- 






07 


REC7 




THIS IS 


RECORD 


NUMBER 7. 


-EOR- 






02 


REC2 




THIS IS 


RECORD 


NUMBER 2. 


-EOR- 






05 


REC5 




THIS IS 


RECORD 


NUMBER 5. 


-EOR- 






01 


REC1 




THIS IS 


RECORD 


NUMBER 1. 


-EOR- 






04 


REC4 




THIS IS 


RECORD 


NUMBER 4. 


-EOR- 






06 


REC6 




THIS IS 


RECORD 


NUMBER 6. 


-EOR- 






-EOI- 







Figure H-2. Input File for Program Creating a Random File (Figure H-l) 
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RECORD NAME RSA 






RECORD 10 




REC1 


6 




RECORD 3 


REC2 


4 


RECORD 7 


REC3 


2 


RECORD 2 


REC4 


7 


RECORD 5 


REC5 


5 


RECORD 1 


REC6 


10 


RECORD 4 


REC7 


3 


RECORD 6 


REC10 


1 


INDEX 






EOF 


EOI 


1 

1 


RANDOM FILE FORMAT 




INDEX RECORD 





Figure H-3. Structure of the Random File Created 
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RLIST 








IDENT 


RLIST, FWA 




ABS 






SST 






TITLE 


RLIST - READ SELECTED LIST FROM RANDOM FILE. 




ENTRY 


RLIST 




ENTRY 


RFL= 




SYSCOM 


B1 


•COMMENT 


READ LIST OF RANDOM FILE. 




COMMENT COPYRIGHT CONTROL DATA 1982. 




SPACE 


4, 10 


*** 


RLIST 


- READ SELECTED LIST FROM RANDOM FILE. 


* 


PROGRAMMER NAME. 82/04/26. 




SPACE 


4, 10 


*** 




THIS PROGRAM READS A SELECTED LIST OF RECORDS 


* 




FROM RANDOM FILE AND WRITES THEM TO FILE OUTPUT. 


* 


SELECTED LIST IS - 


* 




3 


* 




7 


* 




4 


* 




10 




SPACE 


4, 10 


*** 


DAYFILE MESSAGES, 


* 


•INDEX 


OVERFLOW.* = INDEX BUFFER OVERFLOWED. 


* 


•LIST 


COPIED.* = PROGRAM COMPLETE. 




SPACE 


4, 10 


** 


PROGRAM CONSTANTS. 


INDL 


EQU 


101B INDEX LENGTH 


RBUFL 


EQU 


101B RANDOM FILE BUFFER LENGTH 


OBUFL 


EQU 


101 B OUTPUT BUFFER LENGTH 


WBUFL 


EQU 


10B WORKING BUFFER LENGTH 




TITLE 


MAIN PROGRAM. 




ORG 


11 OB 


FWA 


BSS 





R 


BSS 





RANFILE 


RFILEB 


RBUF,RBUFL, (IND=INDEX,INDL) 





BSS 





OUTPUT 


FILEB 


OBUF,OBUFL 


LIST 


BSSZ 


10B LIST TO READ 


RLIST 


SB1 


1 




SKIPEI 


R,R POSITION TO INDEX 




BKSP 


R,R 




BKSP 


R,R 




READ 


R,R READ INDEX 




READW 


R, INDEX, INDL 




ZR 


X1,ERR IF INDEX TOO LARGE 


** 


SET LIST OF RECORDS. 



Figure H-4. COMPASS Program Using READLS Macro to Retrieve a List 
of Records from a Random File (Sheet 1 of 2) 
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MXO 42 






SA1 INDEX+3 


RECORD 3 




BX6 -XO*X1 






SA6 LIST 






SA1 INDEX+7 


RECORD 7 




BX6 -X0*X1 












SA1 INDEX+4 


RECORD 4 




BX6 -X0*X1 






SA6 A6+B1 






SA1 INDEX+10B 


RECORD 10 




BX6 -X0*X1 






SA6 A6+B1 






SX6 LIST 


SET ADDRESS OF LIST 




SA6 R+5 




** 


READ LIST. 




RLI1 


READLS R,R 




RLI2 


READW R,WORK,WBUFL 




NG X1 ,RLI3 


IF END OF FILE 




WRITEW 0,WORK,WBUFL 




EQ RLI2 




RLI3 


SX1 B6-WORK 
WRITEW 0,W0RK,X1 
WRITER 
REWIND R 






MESSAGE (=C*LIST 


COPIED. *)„R 




ENDRUN 




ERR 


MESSAGE (=C*INDEX 

ABORT 

SPACE 4, 10 


OVERFLOW. *),,R 


** 


COMMON DECKS. 




•CALL 


COMCCIO 




*CALL 


COMCWTW 




•CALL 


COMCRDW 




♦CALL 


COMCSYS 
SPACE 4, 10 
USE LITERALS 




** 


BUFFERS. 




INDEX 


EQU * 


INDEX BUFFER 


RBUF 


EQU INDEX+INDL 


RANDOM FILE BUFFER 


OBUF 


EQU RBUF+RBUFL 


OUTPUT BUFFER 


WORK 


EQU OBUF+OBUFL 


WORKING BUFFER 


RFL= 


EQU WORK+WBUFL 
END 


DEFAULT FL 



Figure H-4. COMPASS Program Using READLS Macro to Retrieve a List of 
Records from a Random File (Sheet 2 of 2) 
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REWRITE 



•COMMENT 



*** 

* 

*** 
* 
* 
* 

*** 

* 



FWA 



IDENT REWRITE, FWA 

ABS 

SST 

TITLE REWRITE - REWRITE RANDOM FILE. 

ENTRY REWRITE 

ENTRY RFL= 

SYSCOM B1 

REWRITE RANDOM FILE 

COMMENT COPYRIGHT CONTROL DATA 1982. 

SPACE 4, 10 

REWRITE - REWRITE RANDOM FILE. 

PROGRAMMER NAME. 82/04/26. 

SPACE 4, 10 

THIS PROGRAM UPDATES RECORDS ON A RANDOM FILE. 

RECORD 3 IS UPDATED IN PLACE 

RECORD 1 IS REWRITTEN AT EOI 

THE DIRECTORY IS ALSO REWRITTEN 
SPACE 4, 10 
DAYFILE MESSAGES. 

*INDEX OVERFLOW.* = INDEX TOO LARGE FOR BUFFER 
SPACE 4, 10 
ppQGRAI^ CONSTANTS = 



INDL 


EQU 


101B INDEX LENGTH 


RBUFL 


EQU 


101B RANDOM FILE BUFFER LENGTH 




TITLE 


MAIN PROGRAM. 




ORG 


110B 



BSS 



RANFILE 


RFILEB 


RBUF,RBl 


FL,(IND=INDEX,INDL) 


INDS 


CON 







REWRITE 


SB1 


1 






SKIPEI 


R,R 


POSITION TO INDEX 




BKSP 


R,R 






BKSP 


R,R 






READ 


R,R 


READ INDEX 




READW 


R, INDEX, 


INDL 




ZR 


X1,ERR 


IF INDEX TOO LARGE 




BX6 


X1 


SAVE INDEX SIZE 




SA6 


INDS 





CHANGE RECORD 3 IN PLACE. 



SA1 
MXO 
BX6 
SA6 



SET ADDRESS OF RECORD 3 



INDEX +3 

42 

-X0*X1 

R+6 

WRITEC R,(=C*REC3-1*) 

WRITEC R / (=C*THIS IS UPDATED RECORD 3.*) 
REWRITER R,R 



Figure H-5, 



COMPASS Program to Replace Certain Records on a 
Random File (Sheet 1 of 2) 
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** 


REWRITE RECORD 1 AT EOI. 

SKIPEI R,R POSITION FILE AT EOI 
SA1 R+6 
MXO 42 
LX1 30 

caO nincvj.1 

BX6 X0*X2 PICK RECORD NAME 
BX1 -X0*X1 

BX6 X1+X6 REWRITE NEW ADDRESS 
SA6 A2 

WRITEC R,(=C*REC1-1*) 

WRITEC R / (=C*THIS IS UPDATED RECORD 1.*) 






WRITEC R,(=C*WRITTEN AT EOI BECAUSE LENGTH IS EXTENDED.*) 




WRITER R,R 




** 

1 


REWRITE INDEX. 

SA1 INDS 

WRITEW R,INDEX,X1 

WRITER R,R 

WRITEF R,R 

REWIND R 

MESSAGE <=C*RANFILE UPDATED.*) ,,R 

ENDRUN 




ERR 


MESSAGE (=C*INDEX OVERFLOW.*) ,,R 

ABORT 

SPACE 4,10 




** 


COMMON DECKS. 




*CALL 


COMCCIO 




*CALL 


CGMCWTC 




*CALL 


COMCRDW 




*CALL 


COMCWTW 




•CALL 


COMCSYS 
SPACE 4,10 
USE LITERALS 




** 


BUFFERS. 




INDEX 


EQU * 




RBUF 


ECU INDEX+INDL RANDOM FILE BUFFER 




RFL= 


EQU RBUF+RBUFL DEFAULT FL 
END 





Figure H-5. COMPASS Program to Replace Certain Records on a 
Random File (Sheet 2 of 2) 
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PROGRAMMING STANDARDS 



This appendix describes NOS programming standards including documentation standards and 
coding specifications for COMPASS programs. A COMPASS program follows these standards for 
one or more of the following reasons. 

• To allow the correct use of the NOS documentation processor DOCMENT 

• To ease readability and modification for other programmers 

• To optimize execution and memory requirements 



DOCUMENTATION STANDARDS 

Documentation is the presentation of information about a program in easily understandable 
form so that those who need to understand a program do not need to study the program 
itself. The program documentation is embedded within the source language of each program. 
The documentation should be designed to be extractable by the NOS documentation processing 
program DOCMENT. This approach serves to unify the program and its documentation, making 
it easier and more natural to update as changes are made. 

NOS documentation is of two types . 

• External documentation is produced for the general user 

• Internal documentation describes the internal characteristics of a program (such as 
register usage and subroutine entry and exit conditions) 

For a detailed explanation of how to obtain external and internal documentation, refer to 
the description of the DOCMENT command in Volume 3, System Commands. 

External and internal documentation are further divided in the following levels of 
documentation. 

• How the program functions (design overview) 

• How the program is used (external interface) 

• How the program works (internal interface) 

• Information needed to modify the program (detailed code analysis) 



DESIGN OVERVIEW 

The design overview of a program should describe in general terms the function of the 
program. It should not contain any information about the input parameters, options, error 
conditions, or internal workings of the program. 
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EXTERNAL INTERFACE 

The external interface description includes the following: 
Parameter definitions, formats, and contents 
Initial conditions of buffers and devices 
Status and condition information 
Programs called 
Error codes and messages 
Parameters returned 

INTERNAL INTERFACE 

The internal interface describes the logical flow and structure of the program, the 
algorithms used, and the function performed by each overlay or subroutine in the program. 



DETAILED CODE ANALYSIS 

The detailed code analysis consists of comments within the code itself describing the flow 
of the program. Comments describing the function of logical groups of instructions should 
be provided, and comments documenting table structures, data areas, and constants should 
appear on the instructions which define them. This documentation should provide enough 
detail so that program modifications can be made without adversely affecting existing 
program functions. 

Figure 1-1 is an example of how source code could be arranged to take advantage of the 
DOCMENT features. Figure 1-2 illustrates an external DOCMENT of that program and figure 
1-3 illustrates an internal DOCMENT. 



COMMENT STATEMENT DOCUMENTATION 

Comment statements contain only asterisks and blanks in the first 10 columns and text in 
columns 11 through 71 (columns 72 through 80 are not used). The following rules apply to 
the format of comment statements for documentation. 

• Comment statements with an asterisk only in column 1 indicate that this statement 
is a continuation of internal and external documentation, or it is a comment 
statement not included in the formal documentation (that is, it is not processed by 
DOCMENT). 

• Comment statements with asterisks in columns 1 and 2 indicate internal 
document a tion . 

• Comment statements with asterisks in columns 1, 2, and 3 indicate that this 
statement and all following statements are internal and external documentation. 
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• A statement with four asterisks beginning in column 1 indicates that all following 
statements are internal documentation (whether they are comment statements or not). 
Documentation ends when another comment statement containing four asterisks is 
encounter Gu . 

• A statement with asterisks in columns 1 through 5 indicates that this and the 
following comment statements are internal and external documentation and provide 
the program overview. 

• A statement with an asterisk in column 1 and blanks in columns 2 through 71 is a 
blank comment statement and is used as a separator to improve readability of 
documentation . 
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I DENT DOCTEST 




ENTRY DOCTEST 




SYSCOM B1 




TITLE DOCTEST - DOCMENT TEST PROGRAM. 




SPACE 4,10 


*** 


DOCTEST - DOCMENT TEST PROGRAM. 


* 


THIS PORTION OF THE DOCUMENTATION CONTAINS THE 


* 


PROGRAM OVERVIEW. 


It 

* 


A. B. PROGRAMMER. 82/04/26. 




SPACE 4,10 


*** 


DOCTEST IS A COMPASS PROGRAM WHOSE DOCUMENTATION 


* 


USES SEVERAL OF THE FEATURES PROVIDED BY THE NOS 


* 


DOCUMENT PROCESSOR *DOCMENT*. 




SPACE 4,10 


*** 


DAYFILE MESSAGES. 


* 


* DOCTEST COMPLETE.* - INDICATES COMPLETION OF 


* 


PROGRAM EXECUTION. 




SPACE 4,10 


**** 


ASSEMBLY CONSTANT. 


TUOCC 


EOU 3 CONSTANT THREE 


**** 






TITLE DATA STORAGE. 


** 


DATA STORAGE. 


TEMP 


CON TEMPORARY LOCATION 


TSYM 


SPACE 4,10 


** 


TSYM - TABLE OF SYMBOLS. 


*T 

* 
* 


30/ THREE, 12/ 0, 18/ TEMP 


THREE VALUE OF EQJ SYMBOL. 


* 


TEMP VALUE OF TEMPORARY STORAGE LOCATION. 


TSYM 


BSS 




VFD 30/THREE,12/0,18/TEMP 


DOCTEST 


TITLE MAIN ROUTINE. 


** 


DOCTEST MAIN ROUTINE. 


DOCTEST 


SB1 1 


* 


DAYFILE MESSAGE INDICATING EXECUTION IS COMPLETE. 




MESSAGE DOCA, THREE 




ENDRUN 


DOCA 


DATA C* DOCTEST COMPLETE.* 




SPACE 4,10 




END DOCTEST 







Figure 1-1. Source Code for DOCMENT 
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DOCTEST - DOCMENT TEST PROGRAM. 



82/04/26. EXTERNAL 



OOCTEST - DOCMENT TEST PROGRAM, 

THIS PORTION OF THE DOCUMENTATION CONTAINS THE 

PROGRAM OVERVIEW. 



DOCTEST IS A COMPASS PROGRAM WHOSE DOCUMENTATION 
USES SEVERAL OF THE FEATURES PROVIDED BY THE NOS 
DOCUMENT PROCESSOR *D0CMENT*. 



DAYFILE MESSAGES. 

* DOCTEST COMPLETE.* - INDICATES COMPLETION OF 
PROGRAM EXECUTION. 



Figure 1-2. External Documentation of Program 
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DOCTEST - DOCMENT TEST PROGRAM 



82/04/26. INTERNAL 



DOCTEST - DOCMENT TEST PROGRAM. 

THIS PORTION OF THE DOCUMENTATION CONTAINS THE 

PROGRAM OVERVIEW. 

A. B. PROGRAMMER. 82/04/26. 



DOCTEST IS A COMPASS PROGRAM WHOSE DOCUMENTATION 
USES SEVERAL OF THE FEATURES PROVIDED BY THE NOS 
DOCUMENT PROCESSOR *DOCMENT*. 



DAYFILE MESSAGES. 

* DOCTEST COMPLETE.* - INDICATES COMPLETION OF 
PROGRAM EXECUTION. 



THREE 



ASSEMBLY CONSTANT. 

EQU 3 CONSTANT THREE 



DATA STORAGE. 



TSYM - TABLE OF SYMBOLS. 



5 4 3 2 1 

987654321 098765 4321 0987654321 0987654321 0987654321 0987654321 



/ THREE 



/ 



/ TEMP 



/ 



THREE VALUE OF EQU SYMBOL. 

TEMP VALUE OF TEMPORARY STORAGE LOCATION. 



DOCTEST MAIN ROUTINE. 



Figure 1-3. Internal Documentation of Program 



1-6 



60459690 C 



TABLE GENERATION 

The following points describe special statements used to produce documentation. 

• Documentation statements containing cE in columns 1 and 2 cause the page to be 
ejected. 



The character c preceding an E or T statement is the key character specified by the C 
parameter on the DOCMENT command (the default is an asterisk). 

The cE and cT statements are recognized only if they appear within a set of consecutive 
statements beginning with ccc (external) or cc (internal), where c is the key character. 

For example, the statement 

*T EXAMPLE 24/PP PROGRAM, 18/PARAMETER 1, 18/PARAMETER 2 

generates the following table. 

5 4 3 2 1 
987654321098765432109876543210987654321098765432109876543210 



EXAMPLE /PP PROGRAM /PARAMETER 1 /PARAMETER 2 



The bit position header is generated each time a new block of *T statements is 
encountered. The header is not listed for consecutive table statements or for any 
statement containing a nonblank character in column 3 of the first *T statement in a 
block. The identifier EXAMPLE is optional. 

In the statement format shown, a slash must immediately follow a bit count field; however, 
spaces before the bit count are ignored. All bit counts for field widths can be specified 
in either octal or decimal. Decimal counts are assumed in the absence of a post radix B. 
All table entry description statements within an *T block represent the same total number 
of bits as the first statement. A maximum table width of 60 bits is allowed. 

The slash separates fields in the table. The bit position that the slash occupies is 
included in the field to its left. Single bit fields are not listed with a slash 
separator. Instead, they have a + below the field position. If only one table entry is 
listed, the + is listed both above and below the field position. 
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FURTHER CONSIDERATIONS 

All loader control statements (overlay, section, etc.) are considered special, and their 
images are placed with the page number at the foot of each subprogram to which the 
directive applies. 

All END statements are considered special since they terminate a chapter. 

In COMPASS, the first TITLE statement has special meaning. Its contents (if nonblank) 
replace the page header. All subsequent TITLE statements are ignored. 

In COMPASS, the LIST statement has special meaning. The parameters X and L on a COMPASS 
control statement are processed normally. If a -L is encountered, however, all 
documentation is suppressed until a LIST L statment is encountered. If a -X is 
encountered, no documentation is processed on common text CTEXT until a LIST X statement is 
found. 

The maximum number of these LIST statements that can be processed by DOCMENT is 24. If 
more than 24 LIST X, -X, L, or -L statements are encountered, the following message is 
issued. 

LIST CARD LIMIT - CARD IGNORED. 

iixc wiiiAi 3X1 u ZiHiJA. Statements S.TB Di3CK.et Statements SUXTOUIiuxIig COTJULOu text • No 

documentation is listed unless a LIST X statement is encountered. 



CODING SPECIFICATIONS 

The current NOS coding specifications are contained in a file called CODING. A NOS coding 
standard also exists for SYMPL programs; this standard is contained in a file called 
SYMPCOD.t These files are in 7-bit ASCII format and can be routed directly to an 
upper/lower case ASCII printer or edited using the full screen editor FSE. 

You can convert these files to 6/12-bit display code (for use with some interactive editors 
or for an online manual) using the following commands: 

ATTACH, pfn/UN=LIBRARY (pfn is either CODING or SYMPCOD) 

FC0PY,P=pfn,PC=ASCII8,N=FILE2,NC=ASCII 

(save, list, or edit FILE2) 

To convert these files to 6-bit display code (for example, if your site has only upper case 
print trains), enter the following commands: 

ATTACH, pfn/LN=LIBRARY (pfn is either CODING or SYMPCOD) 

FC0PY,P=pfn,PC=ASCII8,N=FILE2,NC=DIS 

(save, list, edit, or route FILE2) 



TThese files are provided to each site; you should check with your site for instructions 
on accessing these files. The following examples assume that your site has saved the 
files as direct access files under user name LIBRARY. i 

i 
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MAGNETIC TAPE FORMATS 



The standard magnetic tapes used are seven-track, 1/2-inch tape and nine-track, I/2-inch 
tape. Each type of tape can be written in binary or coded (except SI) mode. Unless 
specified otherwise, tapes are assumed to be in binary mode. You can select 200, 556, or 
800 characters per inch (cpi) density for seven-track tapes, or 800, 1600, or 6250 cpi 
density for nine-track tapes, provided these densities are available with the hardware. 
Tape density can be specified by a LABEL, ASSIGN, or REQUEST command (refer to Volume 3, 
System Commands), the LABEL macro (refer to section 4), or an IPRDECK installation option 
(refer to the NOS 2 Analysis Handbook). The system normally performs automatic processing 
of tape parity errors and end-of-tape conditions. However, you can control the processing 
of these functions via the PO keyword on LABEL, ASSIGN, and REQUEST commands, the up and ep 
fields of the FET (FET+1, bits 45 and 44), or the LABEL macro processing options. 



DATA FORMATS 

Data can be recorded on magnetic tape in any of five formats . 
Format Description 



I 


Internal 


S 


Stranger 


SI binary 


System Internalt 


L 


Long block stranger 


F 


Foreign 



The system command user specifies the data format via the F keyword of a LABEL, ASSIGN, or 
REQUEST command. The LABEL macro user specifies the data format via FET+lOg, bits 35 
through 30. The following is a description of the physical and logical characteristics of 
each format. You can define maximum block size, end-of-reel conditions, and noise for any 
format via command or FET parameters; the following description of these characteristics 
defines the suggested (and default) values. 



tNOS/BE system default tape format, 
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f (INTERNAL) FORMAT 

Characteristic 
Header 
Mode 
Block size (PRU size) 



Description 



Labeled or unlabeled. 



Binary. 



Actual data block size can range from to 512 (1000 R ) CM 
words in exact multiples of CM words. All blocks except 
those containing labels include a 48-bit block terminator 
formatted as follows: 



47 


35 


11 


3 


byte count 


block number 





In 



byte count 



block number 



In 



Total number of bytes in the block 
including the block terminator. 

Number of blocks since the last 
HDR1 label. 

Level number: 



Logical end-of-record 



Logical end -of -file 



Logical end-of-information 



17 



8 



End-of-record. 
End-of-file. 



User-specified frame or character counts have no meaning. 

Any block with fewer than 512 (1000 g ) CM words of data is 
considered a logical end-of-record. During a write 
operation, the level number field of the block terminator 
contains the level number obtained from FET+O, bits 17 
through 14, or the WRITECW macro control word. During read 
operations, the system returns end-of-record status and the 
contents of the block terminator level number field. If 
the level number is 
end-of-file status, 
block terminator. 



17g, the system also returns 
Some blocks may consist only of a 



Any block consisting of only a block terminator with a 
level number of 17g is considered a logical end-of-file. 
The system ensures that an end-of-record always precedes an 
end-of-file by writing, if necessary, a block terminator 
with a level number of zero prior to the end-of-file. 

A tape mark followed by an E0F1 label is considered the 
end-of-information. This trailer sequence is generated by 
the system on labeled and unlabeled I and SI format tapes. 
The system issues a label content error if it encounters a 
tape mark without a valid label following it. 
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Characteristic 
End-of-reel 
Noise 

Special considerations 



Description 

Refer to option 3 under End-Of-Tape/End-Of-Reel Conditions. 

Any block containing fewer than eight frames for 
seven-track tapes or six frames for nine-track tapes is 
considered noise and, therefore, is ignored. 

• All nine-track tapes are written in an even 
multiple of bytes. 

• On all read operations, the system checks for fill 
status and compares the number of bytes read and 
the block number expected with the byte count and 
block number values in the block terminator. If 
the specified condition does not occur, the system 
handles it as if it were a parity error. This 
method is designed to prevent dropped or fragmented 
blocks; in general, it provides a much higher 
degree of reliability than any other format. 



S (STRANGER) FORMAT 

Characteristic 
Header 
Mode 
Block size (PRU size) 



Logical end-of-record 



Logical end-of-file 



Description 

Labeled or unlabeled. 

Binary or coded as indicated by FET+0, bit 1. 

No explicit multiple of frames is required. The maximum 
block size may be specified in the mlrs field of FET+6, 
bits 17 through 0. If no block size is specified in the 
mlrs field, it is assumed to be IOOO3 CM words. The 
maximum block size for S format is 1000g. 

If the required block is longer than lOOOg words, the 
tape should be assigned in L format. 

On a CIO READ (010) or READSKP (020) request, each PRU is 
considered an end-of-record. 

Tape mark. 



Logical end-of-information If the tape is unlabeled, there is no logical end-of- 

information. If the tape is labeled, the logical end-of- 
information is a tape mark followed by an EOF1 label. 



End-of-reel 



Refer to option 3 under End-of-Tape/End-of-Reel Conditions. 
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Characteristic 



Noise 



Special considerations 



Description 

Any block containing fewer than 18 frames is considered 
noise and, therefore, is ignored. 

• Level numbers 1 through 16g are interpreted as 
level number 0. 

• Standard code conversion is performed for seven- or 
nine-track tapes in coded mode. 

• For CIO READ (010), WRITE (014), WRITER (024), and 
WRITEF (034) functions, a one-block (PRU) operation 
is performed with the unused bit count (FET+6, bits 
24 through 29) taken from and returned to the FET. 



SI (SYSTEM INTERNAL) FORMAT 

Characteristic 
Header 



Description 



Labeled or unlabeled. 



Mode 



Block size (PRU size) 



Logical end-of-record 



Logical end-of-file 



Binary as indicated by FET+0, bit 1. If coded mode is set 
on an SI tape, the system aborts the job step. (Refer to 
the TCOPY command description in Volume 3, System Commands, 
for details on reading coded SI tapes.) 

The block size can range from to 512 (1000g) CM words 
in exact multiples of CM words. Any block smaller than the 
maximum size except those containing labels contain a 
48-bit block terminator. This terminator has the same 
format as that for I format. 

User-specified frame or character counts have no meaning. 

Any block containing fewer than 512 (1000g) CM words 
represents a logical end-of-record. If a logical record 
consists of an exact multiple of 512 CM words, the block 
that denotes the logical end-of-record consists solely of a 
block terminator. During write operations, the level 
number field of the block terminator contains the level 
number from FET+0, bits 17 through 14, or the WRITECW macro 
control word. During read operations, the system returns 
end-of-record status and the contents of the block 
terminator level number field. If the level number is 
17g, the system returns end-of-file status. 

Same as for I format. 



Logical end-of-inf ormation Same as for I format. 

End-of-reel Refer to option 3 under End-of-Tape/End-of-Reel Conditions. 

Noise Same as for I format . 
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Characteristic 



Special considerations 



Description 

The system writes all nine-track tapes with 3n+2 
mode; that is, the system may write an extra 4 bits 
to tape in order to preserve the lower 4 bits of a 
CM word. 



in.e system aoes not perrons diock checking 
block terminators as is done for I format. 



L (LONG BLOCK STRANGER) FORMAT 

The characteristics and descriptions are the same as for S format tapes except that no 
maximum block size is defined and, if no block size is specified in the mlrs field of 
FET+6, bits 17 through 0, it is assumed to be: 

• LIMIT-FIRST-1 for normal read/write 

• LIMIT-FIRST-2 for READN/WRITEN 

• LIMIT-FIRST-3 for READCW/WRITECW 



F (FOREIGN) FORMAT 

Characteristic 
Label 
Mode 

Block size (PRU size) 



Logical end-of-record 



Description 



Unlabeled. 



Binary or coded, as needed, for seven-track tapes and 
binary for nine-track tapes. 

The block size cannot exceed the CM buffer size. No 
explicit multiple of frames is required. The maximum block 
size must be specified at tape request time. The block 
size is used to determine whether to continue read or write 
operations based on the amount of data versus the space in 
the buffer. For example, if the maximum block size is 
lOOOg CM words, the read operation stops any time that 
less than lOOlg WO rds remain. The user must specify a 
buffer size equal to the largest block size. 

None. 



Logical end-of-file Tape mark. 

Logical end-of-inf ormation None. 

End-of-reel Refer to option 3 under End-of-Tape/End-of-Reel Conditions. 



Noise 



Any block containing fewer than 18 frames is considered 
noise and, therefore, is ignored. 
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Characteristic 



Special considerations 



Description 

• For seven-track tapes, if a parity error is 
detected because the tape is being read in the 
opposite mode, the mode will be switched. 

• F-format operations are done only when using 
control word reads and writes. On read operations, 
the control words are transferred to the user 
regardless of the operation being used. 

Labeled tapes that have been assigned as F format 
will have their labels treated as data. 



END-OF-TAPE/ END-OF-REEL CONDITIONS 

The following is a description of the processing options for end-of-tape (EOT) conditions. 
You can select one of these options by default by specifying the data format; by specifying 
an option via the PO keyword on a LABEL, ASSIGN, or REQUEST command; or by specifying the 
LABEL macro processing option field in FET+lOs, bits 47 through 45. In addition, the 
user processing bit (FET+1, bit 45) gives the user program control over end-of-reel 
c—^dlt^ o n s - i^r further inform-** tim"* r^fe - ** — *"he CLOSER REWIND aid -UNLOAD macros 
described in section 3. 



Option 



Command 
PO Option 



LABEL 
Macro 
PO Bit 

47 



46 



Description 

If, during a write operation, the system 
senses the end-of-tape, it rewrites the 
block on which the EOT occurred as the 
first block on the following reel. No 
trailer information is written on the 
current reel. During a read operation, the 
block on which the EOT occurred is ignored 
and reading continues on the next reel. If 
a tape mark and the EOT are sensed at the 
same time, the EOT is ignored. 

If, during a write operation, the system 
senses the end-of-tape, the system writes a 
trailer sequence, consisting of a tape 
mark, following the block on which the EOT 
was sensed. Any data that occurs following 
the block on which EOT was sensed, yet 
before the tape mark, is ignored. During a 
read operation, the system transfers to the 
user the block on which the EOT was 
sensed. The read operation resumes on the 
next reel. If a tape mark and the EOT are 
sensed at the same time, the EOT is ignored. 
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Option 



Command 
PO Option 



LABEL 
Macro 
PO Bit 

45 



Description 

If, during a write operation, the system 
senses the end-of-tape, the system writes a 
trailer sequence following the block on 



wnicn me* 



sS'JX 



riTao canoaH 



sequence consists of a tape mark followed 
by an E0V1 label for labeled tapes and tape 
marks for unlabeled tapes. The next block 
is written on the next reel. During a read 
operation, the EOT is noted and the system 
transfers to the user the block on which 
the EOT was sensed plus all following 
blocks until a trailer sequence (as 
described above) is recognized. Reading 
resumes on the next reel. 

For options 1 and 2, the system is concerned only with the block on which the EOT is 
sensed. If tapes written using these options are transferred to another system, any data 
that occurs on the reel after this block should be ignored. 



HDR1 LABEL FORMAT 

The format of the HDR1 label is provided here as a reference for the CIO and LFM functions 
decribed in sections 3 and 4. When the HDR1 label is returned to the circular buffer or an 
extended label buffer, it is in this format. For a complete description of each field and 
the formats of other magnetic tape labels, refer to appendix G of Volume 3, System Commands. 
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59 


53 


41 


35 


29 


7 


5 


HDR1 


file identifier (fi) 


file identifier (fi) 


fi 


set identification 


file section number 
(secno) 


secno 


file sequence number 


generation number 


gvn 


gvn 


creation date 


expiration 
date 


expiration 
date 


fa 


block count 


system 


system 


reserved 



file identifier (fi) 

set identification 

file section number 
(secno) 

file sequence number 

generation number 

gvn 

creation date 

expiration date 

fa 

block count 
system 

reserved 



File identifier (up to 17 display code characters, 
left-justified with display code blank fill). 

One- to six-character set identification (left-justified 
with display code blank fill). 

One- to four-digit numeric display code file section number 

vxjLguL juSnncu Wxi.ii uispid) COuS Zero nil/. 

One- to four-digit numeric display code file sequence 
number (right-justified with display code zero fill). 

One- to four-digit numeric display code generation number 
(right- justified with display code zero fill). 

One- to two-digit numeric display code generation version 
number (right-justified with display code zero fill). 

Creation date (two-digit numeric display code value for the 
year followed by a three-digit numeric display code value 
for the day within the year). 

Expiration date (two-digit numeric display code value for 
the year followed by a three-digit numeric display code 
value for the day within the year). 

One display code character indicating the file 
accessibility to the tape. 

Must be zeros. 

Up to 13 display code characters identifying the operating 
system that recorded this file. 

Reserved for future use. 
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SHELL PROCESSING 



The SHELL command sets controls for a command monitoring program. The SHELL command 
includes : 

• The name of the shell program. 

• Where the shell program is to be found (local file, global library, or SYSTEM). 

• The monitoring level (the interactive end-of-job step, outside procedures, inside 
procedures). 

• The optional clearing of controls if the shell program aborts. 

The name of the shell program and shell control bits are stored by CPM in word SHCN of your 
negative field length. 

When the shell program is called, the current command is passed in CCDR (location RA+70B 
through RA+77B) . If there is no current command (as when you are monitoring the interactive 
end-of-job step), RA+70B will be zero. 

The shell program may take any action as a result of the command. Specifically, it may 
issue the same or another NOS command using the EXCST macro. The shell program is not 
called for commands which the program itself originates through the EXCST macro. 

Entering 

SHELL. 

clears word SHCN, and thus disables shell screening. Of course, if a shell program is in 
effect, it may not permit you to enter the SHELL command, and thus may prevent you from 
clearing the shell screening. 

If you wish to monitor commands issued at the interactive end-of-job step, your shell 
program must also read commands from the terminal. This is because 1AJ will load your shell 
program at the interactive end-of-job step, and unless you READ from the terminal, 1AJ will 
continue loading your shell program. 

The following is an example of a shell program that permits the use of non-NOS syntax 
commands (refer to figure L-l). In this example, a simple shell program, SHELDEM, is used 
to permit commands that are longer than seven characters. 

The SHELL command 

SHELL, SHE LDEM,G,T. 

causes a global library load (G option) of the shell program SHELDEM to screen commands 
whenever an interactive command (T option) is entered. 

The valid commands created for this shell example are ASSEMBLER, DOCUMENT, and DOVEDANYA. 
They refer to the procedures CMPSPRC, DOCPROC, and SHELL, respectively. 
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Since SHELDEM is loaded at the interactive end-of-job step, there are no value passes to 
CCDR (RA+70B). SHELDEM prompts the user with a time stamp, and then accepts the next 
command entered by the user. Further processing of the command is caused by the execution 
of a procedure or a NOS command associated with the command. 

1 NOTE 1 

For brevity, SHELDEM has been kept simple. 
It will not handle commands with leading 
blanks , $ signs , lowercase characters , or 
internal blanks. 
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.PROC,SHELLP*l !! DEMONSTRATION of SHELL" 

.IF,FILE(OPL,.NOT.AS).ATTACH-OPL/UN=LIBRARY = 
MODIFY,Q,CS=NOSTEXT,Z./*CREATE,SHELDEM/*EDIT,SHELDEM 
LIBEDIT,P=0,B=LGO,U=SHELBIN,N=SHELLIB,I=0. 
LIBRARY,SHELLIB. 



.DATA, SHELDEM 
SHELDEM 

IDENT SHELDEM, FW A 

ABS 

ENTRY SHELDEM 

SYSCOM B1 



FWA 

*CALL 
*CALL 
*CALL 

IBUFL 
OBUFL 



SHELDEM 
SHD1 



SHD2 



ORG 
BSS 

COMCCMD 
COMCMAC 
COMSTCM 



111B 




ECU 
EQU 



101 B 
101B 



TERMINAL INPUT BUFFER LENGTH 
TERMINAL OUTPUT BUFFER LENGTH 



I BSS 

ZZZZZII FILEC 

BSS 

ZZZZZOO FILEC 



TERMINAL INPUT 

IBUF,IBUFL,DTY=2RTT 

TERMINAL OUTPUT 

0BUF,0BUFL,DTY=2RTT 



SB1 

RJ 

SA1 

ZR 

BX6 

SA6 

SA5 

SA5 

1X3 

NZ 

SXA 

ZR 



1 

GCI 

CCDR 

X1,SHD3 

XI 

CMDSA 

CMDS-1 

A5+B1 

X5-X1 

X3,SHD2 

A5-CMDSA 

X4,SHD3 



PRESET B1=1 

GET COMMAND INPUT 

IF NO COMMAND 

ENSURE COMMAND WILL BE MATCHED 
FWA OF COMMAND TABLE-1 



IF NOT MATCHED 

IF COMMAND NOT IN TABLE 
RETURN TERMINAL INPUT FILE 
RETURN TERMINAL OUTPUT FILE 



RETURN I,R 
RETURN 0,R 
EXCST PRCT-CMDS+A5 EXECUTE CORRESPONDING PROCEDURE 



Figure L-l. Shell Program Example (Sheet 1 of 3) 
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SHD3 


WRITEW 


0, SHDA, SHDAL UNKNOWN COMMAND 




EQ 


SHD1 


LOOP FOR ANOTHER COMMAND 


SHDA 


DIS 


,* SHELDEM - 


- UNKNOWN COMMAND.* 


SHDAL 


EQU 


*-SHDA 




CMDS 


DATA 


L*ASSEMBLER* 


VALID COMMANDS 




DATA 


L*DOCUMENT* 






DATA 


L*DOVEDANYA* CLEAR SHELL PROCESSING 


CMDSA 


BSS 


1 


RESERVE FOR INPUT COMMAND 


PRCT 


DATA 


L*CMPSPRC* 


PROCEDURES (MUST BE SAME ORDER AS CMDS) 




DATA 


L*DOCPROC* 






DATA 


L*SHELL.* 


CLEAR SHELL PROCESSING. 


GCI 


SUBR 




GET COMMAND INPUT 




SA1 


GCIB 


CHECK IF CALLED BEFORE 




NZ 


X1,GCI1 






SX6 


B1 


FLAG CALLED BEFORE 




SA6 


A1 






MX6 


1 


SET FLUSH BIT ON OUTPUT 




LX6 


36*1 






SA1 


0+1 






BX6 


X6+X1 






SA6 


A1 






SETLOF 


GCIC 


SET LIST OF FILES 




RETURN 


I,R 


RETURN INPUT FILE 




RETURN 


0,R 


RETURN OUTPUT FILE 




REQUEST I,U,NMSG 


ASSIGN INPUT TO TERMINAL 




REQUEST 0,U,NMSG 


ASSIGN OUTPUT TO TERMINAL 




WRITE 


0,* 


PRESET WRITE CODE FOR IMPLICIT TT OUTPUT 


6CI1 


PROMPT 


OFF 


TURN OFF IAF *?* 




CLOCK 


GCIA 


OUTPUT TIME PROMPT 




WRITEW 


0,GCIA,GCIAL 




READ 


I 


GET COMMAND 




READO 


I 






ZR 


X1,GCI2 


IF NOT (CR) 




SX6 







GCI 2 


SA6 


CCDR 






EQ 


GCIX 





Figure L-l. Shell Program Example (Sheet 2 of 3) 
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GCIA 


BSS 


1 


TIME STAMP FOR INPUT PROMPT 




VFD 


12/0L>, 


48/0L"EB" END OF BLOCK TERMINAL CONTROL 


WW 1^ 1- 


EQJ 


*-GC LA 


LENGTH qf TIME STAMP STRING 


GCIB 


CON 


" 


ZERO IF FIRST TIME IN GCI 


GCIC 


VFD 


^/^IS/GCID,^/ LIST OF FILES POINTER 


GCID 


VFD 


1/,41/, 


18 /GCIDL LIST OF FILES 




VFD 


/ "1 /n 1 -t T f ~9 7 rtrt 15/A 




VFD 


60/ 




GCIDL 


EQU 


•-GCID 




IBUF 


BSS 


IBUFL 


TERMINAL INPUT BUFFER 


OBUF 


BSS 


OBUFL 


TERMINAL OUTPUT BUFFER 


CALL 


COMCCIO 




CALL 


COMCCPM 




CALL 


COMCLFM 




CALL 


COMCRDO 




CALL 


COMCSYS 




CALL 


COMCWTW 




RFL= 


EOU 
END 


* 


FIELD LENGTH 



Figure L-l. Shell Program Example (Sheet 3 of 3) 
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EXTENDED REPRIEVE PROCESSING M 



The COMPASS program shown in figure M-l illustrates the following. 

• The SETUP function is used to initialize the parameters for the RPV interface. The 
mask bits are set to intercept terminal interrupts. 

• If no error occurs, a user program will loop until XI reaches the maximum value. 

• Any error causes branching to error checking. If the error is of the terminal 
interrupt class, the value in the operating error flag is received. If not, 
branching to unhandled errors occurs, and the program aborts. 

• The terminal interrupt error is assumed to be a user break 1 (CTRL-P). The error is 
compared with the user break 1 mask. If the error is not a user break 1, a user 
break 2 is assumed. The error is then compared with the user break 2 mask. If the 
error is not a user break 2 (CTRL-T) , branching to unhandled errors occurs and the 
program aborts . 

• The type of user break and the value of XI at the interrupt is passed to the dayfile. 

• Control returns to the loop program at the point of interrupt and processing resumes. 
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.PROC,TRYRPV*I. 
.HELP 

P66 CB-AU6-82 TRY OUT EXTENDED REPRIEVE TO DISTINGUISH LB1/UB2. 

REWIND,*. 

. IF, FILE (OPL, .NOT. AS) .ATTACH, OPL/UN=LIBRARY. 

C0MPASS,I=CIN,L=F1,S=N0STEXT,S=PSSTEXT. 
LGO. 

.DATA,CIN 

IDE NT TRY1 

ENTRY TRY1 

SST SO CAN GET PPTEXT/NOSTEXT SYMBOLS 

SYSCOM B1 

OPL XTEXT COMSRPV 

TRY1 SB1 1 B1=1 

* SET REPRIEVE ON TERMINAL INTERRUPT (S) 
REPRIEVE TIHB,SETUP,/COMSRPV/TIMS 

* LOOP UNTIL INTERRUPTED 

BX1 X1-X1 SET X1 TO ZERO 

SX2 B1 

MXO 35 

LOOP 1X1 X1+X2 LOOP UNTIL INTERRUPTED 

BX3 XO*X1 

ZR X3,L00P IF MAXIMUM VALUE STILL NOT REACHED 

ENDRUN OTHERWISE DONE 

* BRANCH HERE ON ANY ERROR 

TIH BSS 

MXO -24 

SA1 TIHB+/COMSRPV/ERCL 

LX1 -12 

BX1 -XO*X1 GET ERROR CLASS 

SX1 X1-/COMSRPV/TICL CHECK FOR TERMINAL INTERRUPT 

NZ X1,ABT IF NOT TERMINAL INTERRUPT 

SA1 TIHB+/COMSRPV/OSEF 

MXO -1 2 

BX1 -XO*X1 GET OPERATING SYSTEM ERROR FLAG 

SA3 =C*USR BRK 1 * ASSUME USER BREAK 1 OCCURRED 

SX2 X1-TIET 

ZR X2,TIH1 IF USER BREAK 1 

SA3 =C*USR BRK 2 * OTHERWISE USER BREAK 2 

SX2 X1 -TAET 

.NZ X2,ABT IF NOT USER BREAK 2 



Figure M-l. Extended Reprieve Example (Sheet 1 of 2) 
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PROCESS TERMINAL INTERRUPT 



TTH1 



RSS 





BX6 


X3 


SA6 


TIHA 


SA1 


TIHX+11B 


QUAL 


IHX 


RJ 


COD 


SA6 


TIHA+2 


MESSAGE TIHA, 3, R 


QUAL 


* 



WHICH USER BREAK 
PUT INTO MESSAGE 
X1 WHEN INTERRUPT OCCURRED 

QUALIFY MESSAGE MACRO 



ISSUE DAYFILE MESSAGE ABOUT USER BREAK 



TIHA 



REPRIEVE TIHB,RESUME,/COMSRPV/TICL CONTINUE ADDING 



VALUE AND ZERO FOR MESSAGE ENDING 



DATA 


H*USR BRK ??* 


DATA 


H*X1 VALUE =* 


BSSZ 


2 W 



ABT BSS UNHANDLED ERROR OCCURRED 

SYSTEM DMD,R,TIHB+/COMSRPV/REPL,TIHB 
ABORT 

TIHB RPVBLK TIH,TIHX TERMINAL INTERRUPT REPRIEVE BLOCK 





QUAL 


IHX 


■ 


QUALS 


SET 





FORCE UNQUALIFIED COMMON DECKS i 


OPL 


XTEXT 


COMCSYS 


, 


OPL 


XTEXT 


COMCCDD 






QUAL 


* 






END 


TRY1 





Figure M-l. Extended Reprieve Example (Sheet 2 of 2) 
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INDEX 



Abnormal termination code 


Abort 




Defined 


C-l 


ABORT macro 


F-l 


Absolute 




Assembly 


C-l 



Access categories 1-20 
Access category 1-17; C-l 
Access category set 5-3 

File 5-2 
Access level 1-17; C-l 

Bit of FET 3-12; 4-16; 5-2,17,19 

File 2-8,10; 3-12,20,33; 
4-2,3,5,6,7,16; 5-3,17 

Job 3-12,13,24,33; 4-6,7 
Access level limits C-l 
Access mode 5-2,10 
Accessing files 3-4 
Account block 

Defined C-l 
Accounting information 6-17 
ACTR symbol 1-8; E-2 
Address 

Error, CIO 3-3 

Registers E-4 
Allocatable device C-l 
Alphanumeric C-l 
ALTER 

Function 3-13 
Al ternate 

Checkpoint file 4-25 

Storage fields 5-22 

User name 2-15; 5-2; C-l 
ALTERNR function 3-13 
ANSI C-l 

ANSI labels 3-15,46; 4-11 
APPEND macro F-l 

Appending information to a file 5-29 
ARGR symbol 1-8; E-2 
Argument address 1-8 
ASCII 

Defined C-l 

Graphic character sets A-l 

Input 12-8 

Output 12-10 

128-character set A-l 
ASCII/display code conversion 4-12 
ASSIGN macro 4-9; F-l 



4-3 

C-l 
3-36,38,41 
1-3 
2-8 



Assigning 

Equipment 4-5,6,7 
Files 4-11 

Nonallocatable devices 4-6 
Packs 4-6 
Resources 4-6,7,11 
Tape units 4-11 
ATTACH macro 5-35; F-l 
Auto 

Drop status 
Input 12-8 
Recall 1-4 
CIO 3-1 
Defined 
LFM 4-1 
* option 
PFM 5-1 
Processing 
Automatic 

File flushing 
Tape assignments 4-16 
Auxiliary device 5-14; C-l 
Auxiliary device requests 5-14 



Backspace status 3-42 
Backspacing a file 3-42,43,53 
Backup requirement 5-2,13 
BASIC subsystem 5-13 
Batch 

Service class E-9 

Subsystem 5-13 
BCD code A-ll 
BCOT origin type E-9 
BCSC service class E-9 
Binary 

File mode bit 2-6 

Formats G-l 

Output mode 12-9 

Random file, FET creation 2-14 
BKSP macro 3-42; F-l 
BKSPRU macro 3-43; F-l 
Block 

Defined C-l 

Size 3-28,32,41; 4-15 
Blocked data format 4-15 
BOI C-l 
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BUF parameter 2-18 
Buffer 

Argument error 12-6 

Circular 2-1 

Defined C-2 

Empty, defined 2-2 

Full, defined 2-2 

Pointers 2-1 

Sizes 2-15,18 

Working 3-54 
Byte C-2 
Bl=l pseudo instruction 1-7 



*CALL directive 1-10 
Capsule 

Defined C-2 
Carriage control, terminal 12-9 
Catalog 

Errors 5-22 

Information 5-21 
Category, file 5-10 



1ST macro 5-1 



i; i~ 



CCAP symbol 5-29 

CCAT symbol 5-35 

CCCT symbol 5-21 

CCDF symbol 5-31 

CCDR symbol 1-9 

CCGT symbol 5-19 

CCPG symbol 5-20 

CCSV symbol 5-15 

CEJ/MEJ option 1-4,9; E-3 

Central memory 

Data error E-5 

Defined C-2 

Dumps 1-17 

Field length 6-14 
Central processor 

Unit C-2 
CHANGE macro F-l 

Character code conversion A-1,9,11 
Character set 

Anomalies A-2 

ASCII A-l 

ASCII graphic 63-character set A-l 

ASCII graphic 64-character set A-l 

ASCII graphic 95-character set A-l 

ASCII 128-character set A-l 

Batch jobs A-2 

Conversion for magnetic tapes A- 11 

Interactive j obs A-2 

Line printers A-3 

NOS-supported A-l 

Tables A-2 

63-character set A-l 

64-character set A-l 
Character sets 1-9 



Checkpoint 

Defined C-2 

Dumps 4-7 

File 4-7,20; C-2 
CHECKPT macro F-5 
Checksum C-2 
CIO 

Abnormal termination codes 3-2 

Common decks 3-4 

Detail error return codes 3-3 

FET format 3-2 

Function processing 3-4 

Function properties 3-4 

Random request processing 3-10 

Read functions 3-24 

Request 3-1 

Status response codes 3-5,6 

Write functions 3-33 
CI0= entry point F-10 
Circular 

Buffer flushing 2-8 

Buffer 2-1; C-2 

Read operation 2-3 

Write operation 2-4 
CKP request 1-17 
CLOCK macro F-l 
CLOSE macro 3-20; F-2 
CLOSER macro 3-23; F-2 
Closing a file 3-20 
CMU option 1-8 
CMUR symbol 1-8 
Code set 

ASCII A-l 

Definition A-l 

Display code A-l 

NOS-supported A-l 

12-bit ASCII code A-l 

6/12 display code A-l 
Coded 

File mode 2-6 

Random file, FET creation 2-15 
Coding specification 1-8 
Colon representation A-2 
Combined input /output 3-1 
COMCARG F-8 
COMCARM F-8 
COMCCDD F-8 
COMCCFD F-8 
COMCCHD F-8 
COMCCIO F-8 ,10 
COMCCMD F-7 
C0MCC0D F-8 
COMCCPA F-8 
C0MCCPM F-8 , 10 
C0MCCPT F-8 
COMCCVI F-8 
C0MCCVL F-8 
COMCDXB F-8 
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COMCECM 


D-l; F-8 


COMCECS 


D-l; F-9,11 


COMCEDT 


F-9 






COMCGTO 


F-9 


COMCHXB 


F-9 


COMCLFM 


F-9,11 


COMCLOD 


F-9 


COMCMAC 


F-5 


COMCMTM 


F-9 


COMCMTP 


F-9 


COMCMVE 


F-9,11 


COMCOVL 


F-9,11 


COMCPFM 


F-9,11 


COMCPOP 


F-9 


COMCRDC 


F-9,11 


COMCRDH 


F-9,11 


COMCRDO 


F-9,11 


COMCRDS 


F-9,11 


COMCRDW 


F-9,11 


COMCRSP 


F-9 


COMCSFM 


F-9 


COMCSFN 


1-13; F-9 


COMCSNM 


F-9 


COMGSRT 


F-9 


COMCSSN 


F-10 


COMCSST 


F-10 


COMCSTF 


12-6; F-10 


COMCSYS 


F-10, 11 


COMCUPC 


F-10 


COMCUSB 


F-10 


COMCVDT 


F-10 


COMCVLC 


F-10 


COMCWOD 


F-10 


COMCWTC 


F-10, 11 


COMCWTH 


F-10, 11 


COMCWTO 


F-10, 11 


COMCWTS 


F-10, 11 


COMCWTW 


F-10, 11 


COMCZAP 


F-10 


COMCZTB 


F-10 


Command 




Count 


4-10 


Defined C-2 


File 


4-10 


Image 


1-9; E-3 


Parameters 12-1 


Record C-2 


Command memory manager 


Comment f 


ield 1-7 


Common decks 


Available to user 


CIO 


3-4 


Data 


transfer macros 


Defined C-2 


LFM 


4-1 


PFM 


5-1,3 


Relocatable F-10 



SYSLIB F-10 
Usage 1-9 
Compare/move unit 



C-2 



E-3 



F-l 



3-58 



Compile file format, compressed G-10 
Compressed 

Compile file format G-10 

Text G-4 
COMSMLS 5-17 
COMSPFM 5-1,3,10 
COMSVLC 5-17 
Concatenation symbol A-3 
Control 

Byte 12-7; C-2 

Character A-l 

Keys 12-12 

Program execution 12-12 

Words 3-27,36; 5-2 
CONTROL macro F-2 
Control point 

Defined C-2 
Conversion 

Mode 4-12 

Of programs 12-4 
CPCOM F-l 
CPM 6-1 

CPM= entry point F-10 
CPU 

Common decks 1-9; F-l 
Creating 

Direct access file 5-31 

Indirect access file 5-15 

Labeled tape 4-11 

Random file H-l 
Creation date 2-12; 4-16; J-8 
CSET macro F-5 
CSMR symbol 1-9; E-3 
Current 

Random index 2-10,12,13; 3-3 
CYBER loader C-3 
CYBER record manager 

Defined C-3 

I/O 3-62 



Data 

Error in file 5-22 
Format 4-15; J-l 
Transfer macros 3-54 

Data security 1-20 

DATE macro F-2 

Dayf i le 

Defined C-3 
Messages 4-14 

DCB= entry point F-ll 

Deadstart service class E-9 

DED request 1-17 
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Default 

Defined C-3 

File assignments 12-4 
Deferrred routed file type E-5 
DEFINE macro 5-31; F-2 
Density, tape 4-12 
DEP request 1-17 
Detached service class E-9 
Detail error return code 3-3 
Device 

Auxiliary 5-14 

Not ready error 3-3 

Reserved error 3-3 

Status errors 3-3 

Type 2-6,18; 4-4; C-3 
Device type E-10 
Diagnostic messages B-l 
Direct access files 

Attaching 5-35 

Creating 5-31 

Defined C-3 

PRUs desired 5-2 

Purging 5-20 
Direct access permanent file type E-5, 8 
Disable 

Hardware exit mode E-5 

Program exit mode E-5 
DISC service class E-9 
Disconnect terminal 12-8 
Display code 

Conversion 4-12 

Defined C-3 
Display mode 11-29 
Disposition code C-3 
DISTC macro F-5 
Division, integer 1-7 
DMB request 1-17 
DMD request 1-17 
DMP request 1-17 
DOCMENT command 1-1 
Documentation 

Cards 1-2 

Standards 1-1 
DOJS symbol E-7 
DSSC service class E-9 
DTCS symbol E-6 
DTY parameter 2-16,18 
Dump 

Memory 1-17 



*E directive 1-7 
EBCDIC character code 
ECSTEXT 1-6; D-l 
EDATE macro F-5 
EIOT origin type E-8 



A-ll 



EJT 

Connection status codes E-6 

Job status codes E-6 
EJT scheduling data E-7 
EM register E-5 
Empty buffer, defined 2-2 
Empty PRU/record C-3 
ENCSF macro 4-10 
End-of-block 12-7 
End-of-device 

Processing 2-6 

Status 3-2 
End-of-file C-3 
End-of-information C-3 
End-of-line 12-7; C-3 
End- of- line byte A-2 
End-of-record C-4 
End-of-reel 3-2,23; 4-15; J-6 
End-of-reel processing 2-6 
End-of-string byte 12-10 
End-of-tape C-4 
End-of-tape processing 4-15; J-6 
End-of-transaction block 12-10 
ENDRUN macro F-2 
Entry point C-4 
EOF 2-5,6 
E0F1 label 3-21,22 
EOF2-9 labels 3-22 
EOI 2-6 

E0V1 label 3-22,23 
E0V2 label 3-23 
EPR parameter 2-16 
Equipment 

Code C-4 

File assignment 4-6 , 7 

Status table C-4 
Equipment access levels C-4 
ERA parameter 2-18 
EREXIT macro F-2 
ERJS symbol E-7 
ERP parameter 2-18 
Error 

Codes 

CIO 3-2 
LFM 4-2 
PFM 5-4 

Correction 4-13 

Exit address E-5 

Exit mode E-5 

File length 5-22 

Flag E-ll 

Messages B-l 

Permit entries 5-22 

Processing bit 2-7,16,18; 5-1 

Processing 2-7; 4-12 

Recovery 4-13 

Return address 2-18 



Index-4 
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Escape code A-l 






EST ordinal C-4 






ETIME macro F-5 






PIFTPT ™o„,-„ l — Hl. IT- 


2 




jji±u± uiovlu •" ■' *■ y * 






Evicting a file 3-51 






Exchange 






Jump instruction 


1- 


•5; C- 


Package C-4 






EXCST macro F-5 






Execute subsystem 5- 


13 




Executive auto input 


12 


-10 


Exit mode C-4; E-5 






EXJS symbol E-6 






Expiration date 4-16 


; J 


-8 


Extended 






Core storage C-4 






Instruction stack 


purg ing 


Label processing 


3; 


2-8 


Memory 






Defined C-5 






Field length 


6- 


14 


Parity error 


E- 


5 


Transfers D- 


1 




Semiconductor memory 


c-: 


External 






Documentation I- 


2 




Reference C-5 







Field length 

Central memory 
Defined C-5 



BvhonJflJ 



C-4 
3-17; C- 



F format tape 4-15; J-1,5 
FAFT file type E-5, 8 
Family 

Device C-5 
Fast 

Attach file type E-5 

Dynamic loader C-5 
Fast attach file type E-8 
FCPB category 5-12 
FCPR category 5-12 
FCSP category 5-12 
FET 

Access level bit 

Creation macros 

Description 2-4 

Formats 

CIO requests 
LFM requests 
PFM requests 
Standard 2-4 

LABEL macro 4-11 

Length 2-9,16 

Modification macro 2-17 

Parameters 2-15 

^Pointers 12-5 

Status bit 1-3 



3-12; 
-11 



3-2 
4-1 
5-1 



4-16; 5-2,17,19 



E-4 



E-4 



Extended memory 

Reducing 6-14 
File 

Access category set 5-2,3 

Access level 2-8,10; 3-12,20,33; 
4-2,3,5,6,7,16; 5-3,17,23 

Accessibility 4-16; J-8 

Assigning 4-6,7 

Backspacing 3-42,43,54 

Backup requirement 5-2 

Binary 2-6 , 14 

Category 5-1,12 

Coded 2-6 , 14 

Creation date 2-12 

Data error 5-22 

Defined C-5 

Direct access 5-31 

Flushing 2-8; C-6 

Identifier 2-11; 4-16; J-8 

Information 4-26 

Interactive subsystem 5-2 

Local 4-1 

Mode 2-6; 5-2,10 

Mode bit 3-3 

Name table C-6 

Name table word C-6 

Name 2-5 

Overwriting 3-40 

Password 5-2,4 

Permission mode 5-2,10 

Position 4-5 

Positioning functions 3-42 

Preferred residence 5-2 

Private 5-12 

Public 5-12 

Purging 5-20 

Random 2-9,11; 3-10; C-10 

Residency 5-14,31 

Returning 3-45 

Rewinding 3-43 

Saving 5-15 

Section number 2-14; 4-16 

Semiprivate 5-12 

Sequence number 2-11; 4-16 

Sequential 2-14; C-ll 

Set C-6; J-8 

Skipping 3-52 

Space, releasing 3-45,51 

Status 4-3 

Types 4-18,19; E-8 

Utility table word C-6 
File access category C-5 
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File access level C-6 

File environment table 2-1; C-6 

FILEB macro 2-12; F-2 

FILEC macro 2-12; F-2 

FILINFO macro 4-26; F-2 

FIRST address 2-2,9 

First word address 2-10 

Flag C-6 

Flush bit 2-8; 12-5 

FNT 

Pointer 2-9 

Word 4-5 
Foreign format tapes J-5 
Formats , magnetic tape J-l 
FORTRAN subsystem 5-13 
Frame C-7 
FST 

Entry 4-20 

Word 4-5 
FTNTS subsystem 5-13 
Full buffer, defined 2-2 
Full -track C-7 
Functions 

iij_lJ.il j^V J"iJ 

ALTERNR 3-13 

IRESUME 10-9 

NR 3-13 

READ 3-13 

READNR 3-13 

REEL 3-13 

REELNR 3-13 

RESET 10-9 

RESUME 10-9 

RETURN 3-20 

REWIND 3-20 

SETUP 10-9 

UNLOAD 3-23 

WRITE 3-13 

WRITENR 3-13 
Function processor C-7 
FWPR symbol 1-8; E-3 



GE write mode 4-13 

Generation 

Defined C-7 
Number 4-16; J-8 
Version number 2-11 

GET macro 5-19; F-2 

GETACT macro F-7 

GETASL macro F-5 

GETEM macro F-7 

GETFLC macro F-5 

GETFNT macro 4-18; F-5 

GETGLS macro F-5 

GETJA macro F-5 

GETJAL macro F-5 

GETJCI macro F-7 



GETJCR macro 6-15; F-5 

GETJN macro F-5 

GET JO macro F-5 

GETJOSC macro F-6 

GETJSL macro F-6 

GETLC macro F-6 

GETLOF macro F-7 

GETMC macro F-6 

GETPAGE macro F-6 

GETPFP macro F-6 

GETPR macro F-6 

GETSS macro F-6 

GETSSID macro F-6 

GETSSM macro F-6 

GETTL macro F-6 

GETUSC macro F-6 
Global 

Library set 12-2; C-7 
Global library set E-2 
Graphic character A-l 



Half track C-7 
Hardware error exit mode E-5 
HDR1 label 3-16,46; 4-16; J-7 
Header documentation 1-7 
HTIME macro F-2 



I format tape 4-15; J-l, 2 
IAF 12-6 
IN address 2-2,9 
Increment registers E-4 
IND parameter 2-16 
Indefinite operand E-5 
Index length 2-10,16 
Index, random 2-9 
Indirect access files 

Accessing 5-19 

Appending information 5-29 

Creating 5-15 

Defined C-7 

Purging 5-20 

Saving 5-15 

Working copy 5-19 
INFT file type E-8 
Inhibit error processing 4-12 
Initiate ASCII output 12-10 
Input 

ASCII 12-8 

Binary 12-8 

Transparent 12-8 
Input file 
INPUT* file 3-45 

Releasing 3-45 

Returning 3-45 

Type C-7; E-5 
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Input file type E-8 
Input/output 

Buffers 2-1; 3-54 

nexwa a go 1_ 1 

CYBER record manager 3-62 
Integer divide instruction 1-7 
Interactive 

Facility 12-6 

Origin type E-8 

Programs 12-4; C-7 

Service class E-9 
Internal 

Auto input mode 12-10 

Documentation 1-1 

Format tape J-2 
Interrecord gap C-7 
Interrupt C-7 
IOJS symbol E-7 
Irrecoverable parity error 4-12 



JDATE macro F-2 
Job 

Access level 3-12,13,24,33; 4-6,7 

Communication area E-l 

Control registers 6-15,16 

Field length 6-14 

Origin type 1-9; E-3 

Step C-8 
Job access category set C-7 
Job access level C-7 
Job access level limits C-7 
JOPR symbol 1-9; E-3 



L format tape 

Defined J -5 

Reading 3-31 

Specification 4-15 

Writing 3-41 
Label 

Bit 4-11 

Buffer 3-17,47 

Defined C-8 

Verification 3-13 
LABEL macro 4-11; F-2 
Label processing 

ANSI tapes 4-11 

Extended 2-8; 3-17,47 

Standard 2-8; 3-15,46 
Labeled tape 4-11 
Large central memory extended C-8 
Last word address 2-10 
LBL parameter 2-16 
LB1W word 6-13 
LCB= entry point F-ll 



LDR completion 1-9 
LDRR symbol 1-9; E-3 
Length 

Clf TTFT 9-Q lfi 

"■- *"*■ «• '»■■■« 

Of index 2-10,16 
Level 

Designator C-8 

Number 2-5; 3-2,27; C-8 
LFM 

Call format 4-1 

Common decks 4-1 

Error codes 4-2 

FET format 4-1 

Request 4-1 
LFM= entry point F-10 
LFN parameter 2-18 
Library C-^8 
Library file 

Accessing 4-9 

Defined C-8 

Returning 3-45 

System default 1-9 

Type E-5 
Library file type E-8 
Library flag E-2 
LIFT file type E-5, 8 
LIMIT address 2-2,9 
Line 

Defined C-8 

Feed, suppress 12-10 

Printer usage A-3 
Lines/printer page 1-9 
LINP symbol 1-9 
List address 2-10; 3-29 
List of files 2-8; 12-5; C-8 
Load point C-8 
LOADD macro F-6 
Loader control word 6-13 
LOADQ macro F-6 
Local batch origin type E-8 
Local file 

Defined C-8 

Name 2-5,15,18; C-8 

Name table C-8 

Releasing 3-51 

Type E-5 
Local file type E-8 
Local FNT entry 4-18 
LOCK macro 4-4; F-2 
Locked file C-8 
Locked files 4-4 
LOFT file type E-5, 8 
Log-off user 12-8 
Logical identifier C-8 
Logical record 3-28; C-9 
Long block stranger format tapes J-5 
LWPR symbol 1-8 
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MACHID macro F-7 

Macro C-9 

MACRO pseudoinstruction 1-7 

Magnetic tape files 

Accessing 3-13; 4-11 

ANSI standard labeled 3-15; 4-11 

Assignment 4-11 

Block size 4-15; J-l 

Buffer size 2-15 

Closing 3-21,23 

Creating 3-13; 4-11 

Evicting 3-51 

Formats J-l 

Labeling 3-15; 4-11 

Multifile set 3-46 

Nonstandard labeled 3-15 

Opening 3-13 

Requesting 4-11 

Returning 3-45 

Rewinding 3-43 

Standard FET 2-5 

Unlabeled 3-15 

Unloading 3-44 
Maintenance service class E— 9 
Map flags, loader 6-13 
MASC service class E-9 
Mass storage 

File 

Overwriting 3-40 
Mass storage files 

As signment 4-6,7 

Buffer size 2-15 

Closing 3-20 

Evicting 3-51 

Opening 3-13 

Returning 3-45 

Rewinding 3-43 

Standard FET 2-4 

Unloading 3-44 
Mass storage operations 3-14 
Maximum 

Field length 6-14 

Logical record size 2-11; 3-3 
MEMORY macro F-2 
Message buffer 12-6 
Minimum buffer size 2-15 
mlrs 2-10; C-9 
Mode, error exit E-5 
Mode, file 2-6 
Mode, file access 5-2,12 
MODE macro F-7 
Modification 

History byte G-4 

Table G-4 
Modify 

*CALL directive 1-10 

Library file format G-2 
MOVE macro F-2 



MSG= entry point 
Multifile 

File 

Reels 

Set 

Sets 



F-ll 



C-9 
3-46 
C-9 
3-46 

Tape, positioning 3-46 
Multireel files 3-46 
Multiunit device 5-14 
MVE= entry point F-10 



Name change, file 4-2 
Network 

Defined C-9 

Supervisor service class E-9 

Terminal C-9 
New 

File name 4-2; 5-2 

Permanent file name 5-2 
NICS symbol E-6 
No auto drop status 4-3 
Noise size 4-15; J-l 
Nonailocatable device C-9 
Nonstandard 

Label bit 4-11 

Labels 3-15; 4-11 

Tape label C-9 
NORERUN macro F-6 
Normal 

Exit address E-5 
NOSTEXT 1-6 
NPC= entry point 12-2 
NR function 3-13,20,23 
NSSC service class E-9 
Null subsystem 5-12 



OFFSW macro F-2 
OLCS symbol E-6 
Old 

Program library C-9 
OLD macro F-2 

On-the-fly error correction 4-13 
ONSW macro F-2 
Opdef C-9 

OPEN macro 2-9; 3-13; F-2 
Opening a file 3-13 
Operand 

Out of range E-5 

Registers E-5 
Operating 

System format 12-2 
Operator assignment of tapes 4-16 
OPL 

Common decks 1-9; G-3 

Format G-2 
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OPLD format 


G-5 






OUT address 


2-3, 


,9 




Output 


2-8 




Binary 12-9 
Transparent 
Overlay C-9 

AttwnT i V — _ ~— TO- 


12- 


-9 



Overwriting file space 
OVL= entry point F-ll 
OVWRITE macro F-2 



3-40 



Pack name 2-16,18; 5-2,14; C-9 

Packed 

PACKNAM macro F-7 

Parameter 

Defined C-9 

Processing 12-1 
Parameters , command E-2 
Parameters, RA+1 call 1-3 
Parity 

Defined C-9 

Errors 3-3,28 
Password 

Defined C-9 

Expiration date 5-2,4 

Expiration term 5-2 

File 2-16,18; 5-2 
PDATE macro F-2 
Peripheral processor C-10 
Permanent file 

Backup requirement 5-2 

Catalog 5-21; C-10 

Categories 5-12 

Defined C-10 

Devices 5-14 

Direct access 5-31 

Family C-10 

Indirect access 5-15 

Information 5-21 

Name 2-16,18; 5-1 

Permission 5-10 

Preferred residence 5-2,13 

Purging 5-20 

Real-time processing 5-1 

Returning 3-45,51 

Subsystem 5-2 
Permission, file 5-10 
Permission information 5-21 
Permission modes 5-10 
Permit entry error 5-22 
PERMIT macro F-2 
PFM 

Common decks 5-1,3,10 

Error codes 5-4 

FET format 5-1 



Parameter 2-16 

Registers used 5-2 

Request 5-1 
PFM= entry point F-ll 
pfn parameter 2-16,18 
PGNR symbol 1-8; E-2 
Physical record C-10 

pkn parameter 2-16,18 
PMFT file type E-5,8 
Positioning a file 3-42 
P0SMF macro 3-46; F-2 
PP 

Absolute overlay G-l 
PPTEXT 1-6 

Preferred residence 5-2 , 13 
Primary file C-10 
PRIMARY macro 4-26; F-6 
Primary terminal file 

Creation 4-26 

Type E-5 
Primary terminal file type E-8 
Print file C-10 
Print trains A-3 
Private auxiliary device C-10 
Private file 5-12 
PRJS symbol E-6 
PROC record format G-9 
Procedure 

Record format G-9 
Processing 

Options, tape 4-12 

Tape requests 3-15 
Product set format 12-2 
Program 

Abort 12-6 

Address E-4 

Conversion 12-4 

Error exit mode E-5 

Library C-10 

Library directory format G-5 

Parameter area 1-8; E-2 

Text documentation 1-8 
PROMPT macro F-6 
PROTECT macro F-7 
PRU 

Device C-10 

Magnetic tape J-l 

Mass storage 2-9 

Reading 3-25 

Size 2-9; 3-28; 4-15; J-l 

Writing 3-34 
PSCSF macro 4-10; F-6 
Pseudoinstruction C-10 
PSSTEXT 1-6 
PTAP mode 5-10 
PTEX mode 5-10 
PTFT file type E-5,8 
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PTMD mode 


5-11 


PTNU mode 


5-11 


PTRA mode 


5-11 


PTRD mode 


5-10 


PTRM mode 


5-11 


PTRU mode 


5-11 


PTUP mode 


5-11 


PTWR mode 


5-10 


Public 




Auxiliary device 


File 


5-12 


Punch file 


C-10 


PURGE macro 


5-20; F-2 


Purging files 5-20 


PWD parameter 2-16,18 



C-10 



QAC 

ALTER request 8-9 
Error codes 8-2 
GET request 8-13 
Interface 8-1 
Parameter block 8-1 
PEEK request 8-15 
RA+1 call 8-1 
Request 8-1,7 
Selection flag 8-5 

QFFT file type E-5,8 

QUAL pseudoinstruction 

QUAL$ tag 1-13 

Qualified symbol C-ll 

Qualifying common decks 

Queue 

Queued file table C-ll 



1-13 



1-13 



RA E-l 

RA.CEJ symbol 1-9 

RA.CMU symbol 1-8 

RA.MTR symbol 1-8 

Random 

Access 3-10; C-ll 

Access bit 2-6 

Address 3-3 

File C-ll 

File, sample H-l 

I/O, examples H-l 

Index 2-9; 3-3 

Request 2-10; 3-10 

Rewrite request 2-10; 3-3 
RA+1 requests 1-4,5 
RBSC service class E-9 
RCL= entry point F-ll 
RDC= entry point F-ll 
RDH= entry point F-ll 
RD0= entry point F-ll 



RDS= entry point F-ll 
RDW= entry point F-ll 
RDX= entry point F-ll 
READ function 3-13 
Read functions 3-24 
READ macro 3-25; F-3 
Read/write 

Extended memory D-l 

Random 3-10 
READC macro 3-58; F-3 
READCW macro 3-27; F-3 
READEI macro 3-32; F-3 
READH macro 3-59; F-3 
Reading 

ANSI labels 3-15; 4-11 

Labels 3-15,16; 4-11 
READLS macro 3-29; F-3 
READN macro 3-32; F-3 
READNR function 3-13 
READNS macro 3-31; F-3 
READ0 macro 3-60; F-3 
READS macro 3-60; F-3 
READSKP macro 3-27; F-3 
READS macro 3-61; F-3 
Real-time 

Processing bit 2-18 
REC= entry point F-10 
Recall 1-3; C-ll 
RECALL macro F-3 
Record 

Defined C-ll 

Separator C-ll 

Skipping 3-52,54 
Reel C-ll 
REEL function 3-13 
REELNR function 3-13 
Reference address C-ll; E-4 
Referred routed queued file type 
Register 

Defined C-ll 

Job control 6-15,16 
Relative address G-ll 
Releasing 

Job attachment 3-45,51 
Relocatable assembly C-ll 
Remote 

Batch origin type E-8 

Batch service class E-9 
Removable device C-ll 
RENAME macro 4-2; F-3 
Renaming a file 4-2 
REPLACE macro F-3 
REPRIEVE macro F-7 
Request code 2-6; 3-2 
REQUEST macro F-3 
REQUEST macro (015) 4-7 
REQUEST macros 4-6 
Request processor 1-1 



E-8 
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Request/ return codes 2-6; 3-2 

Requests, system 1—2 

RERUN macro F-6 

Residence, file 5-14 

Residence, preferred 5-13 

Retention cycle 2-11 

RETURN 

Function 3-20 

Macro 3-45 

Versus EVICT macros 3-51 

Versus UNLOAD macros 3-45 
Return code 2-6 
RETURN macro F-3 
Returning a tape file 3-45 
REWIND function 3-20 
REWIND macro 3-43; F-3 
Rewinding a file 3-43 
REWRITE macro 3-38; F-3 
REWRITEF macro 3-39; F-3 
REWRITER macro 3-39; F-3 
RFILEB macro 2-12; F-3 
RFILEC macro 2-15; F-3 
ROFT file type E-5,8 
ROJS symbol E-6 
Rollout 

Defined C-12 

File C-12 

File type E-5 
Rollout file type E-8 
ROLLOUT macro F-6 
Rotating mass storage C-12 
ROUTE macro F-3 
RPHR macro 3-25; F-3 
RPHRLS macro 3-30; F-3 
RPVBLK macro F-7 
RTIME macro F-4 
Running field length 6-14 



S format tape J-3 

Reading 3-31 

Writing 3-41 
SAVE macro F-4 
Sector C-12 

Secure system memory 1-17 
Secured system 1-17; C-12 

CIO processing 3-12 

Permanent file access 5-3 
Security 
' Access categories 1-17,20; 5-2 

Access level 4-3 

Access levels 1-17 

Conflict 1-21 

Considerations 1-17 

Count C-12 
Security administrator C-12 
Security conflict 3-33 



Security unlock status C-12 
Semiprivate files 5-12 
Sense switches C-12 
Sequential 

Access C-12 

File C-12 
Service class E-9 

Qat- <J^Hf4/.»H n „ 9.11. /,_1£ 

Set, magnetic tape 3-46 

SETASL macro F-7 

SETFAL macro 4-3; F-6 

SETFET macro F-7 

SETFET parameter processing 2-19 

SETFS macro 4-3; F-4 

SETGLS macro F-6 

SETJAL macro F-6 

SETJCI macro F-7 

SETJCR macro F-6 

SET JOB macro F-6 

SETJSL macro F-7 

SETLC macro 6-13; F-6 

SETLOF macro F-8 

SETMFL macro F-8 

SETPAGE macro F-6 

SETPFAC macro F-4 

SETPFAL macro F-4 

SETPR macro F-6 

SETRFL macro 6-14; F-8 

SETSC macro F-6 

SETSLM macro F-7 

SETSS macro 6-16; F-7 

SETSSM macro F-7 

SETTL macro F-8 

SHELL macro F-8 

Short PRU C-12 

SI format tape J-4 

SIJS symbol E-6 

SKIPB macro 3-53; F-4 

SKTPEI macro 3-53; F-4 

SKIPF macro 3-52; F-4 

SKIPFB macro 3-54; F-4 

SKLPFF macro 3-52; F-4 

SOJS symbol E-6 

Special 

Entry point C-12 

Error flags E-12 

File treatment 12-3 

Handling 12-5 
Specifying subsystem 6-16 
SSSC service class E-9 
SST pseudoinstruction 1-6 
Stack purging E-4 
Standard labeled tape C-12 
Status bit of FET 1-3 
STATUS macro F-4 
STATUS macro (012) 4-4 
STATUS macro (013) 4-5 
STIME macro F-4 
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Stranger format tape J-3 
SUBR macro F-7 
Subsystem 

Ordinal 6-16; 11-30 

Service class E-9 
SUJS symbol E-7 
SYFT file type E-5,8 
Symbol C-12 
SYOT origin type E-8 
SYS= entry point F-ll 
SYSC service class E-9 
SYSCOM macro 1-8; F-4 
System 

File C-13 

File name table C-13 

File type E-5 

Internal format tape J-4 

Labeled tape C-13 

Library C-13 

Origin type E-8 

Request 1-2; C-13 

Resource unit C-13 

Service class E-9 

System access category set C-13 

System access levels C-13 

System file type E-8 

System library E-2 

SYSTEM macro F-4 

Systems texts 1-6 

SYSTEXT 1-6 



TSSC service class E-9 
TSTATUS macro 11-30; F-7 
TXQT origin type E-8 



UCW parameter 2-18 

UHL label 3-18 

ULIB format G-7 

Underline symbol A-3 

Unified extended memory C-13 

Unlabeled tape C-14 

UNLOAD function 3-23 

UNLOAD macro 3-44; F-4 

UNLOCK macro 4-4; F-4 

Unprintable characters A-3 

Unsecured system 1-17; C-14 

Unused bit count 2-10; 3-41 

USECPU macro F-4 

User 

Header label 3-18 
Index C-14 

Library group format G-7 
Processing bit 2-6 
Trailer label 3-22 
Volume label 3-18 

User library E-2 

USERNUM macro F-4 

USN parameter 2-18 

UVL label 3-18 



Tape 

Error messages 4-14 

Format C-13 

Mark C-13 
Temporary file C-13 
Terminal 

Class 11-31 

Classes 12-10,11 

Control keys 12-12,13 

Display mode 11-29 

Input 12-4,5 

Model 11-29 

Prompt 12-8 

Redefinition 12-10 

Status bits 11-31 

Status 11-30 
Text 

Format 6-4 

Record format G-9 
Time 

Slice C-13 
TIME macro F-4 
Timed/event rollout C-13 
TOJS symbol E-7 
Transmission code 11-31 



Validation file C-14 
VERSION macro F-8 
Volume 

Defined C-14 

Serial number C-14 
V0L1 label 3-18 



WATT macro F-4 

WEC= entry point F-10 

WNB- entry point F-ll 

Word C-14 

WPHR macro 3-34; F-4 

Write 

Lockout bit 4-4 

Ring C-14 
WRITE macro 3-34; F-4 
WRTTEC macro 3-59; F-4 
WRITECW macro 3-36; F-4 
WRITEF macro 3-35; F-4 
WRITEH macro 3-59; F-4 
WRITEN macro 3-41; F-4 
WRITEO macro 3-60; F-4 
WRITER macro 3-35; F-5 
WRITES macro 3-41,61; F-5 
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WRITEW macro 3-61; F-5 
WTC= entry point F-ll 
WTH= entry point 



WTS= entry point 
WTW= entry point 
WTX= entry point 



F-ll 
F-ll 
F-ll 
F-ll 

F-ll 



-2,5 



Zero-byte terminator C- 
Zero-length PRU C-14 
ZZZZDMB file 11-14 



14 



XJ instruction 1- 
XJPR symbol E-3 
XTEXT pseudoinstruction 



1-10 



029 punch code A-3 
63-character set A-l 
64-character set A-l 
95-character set A-l 
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